API PCARTS

API PC ARTS

Operación 1005: Consulta Catálogo Distribución

URL: https://api.pcarts.com/operations
Método: GET.
Header:

Parámetro Header
Valor
Observaciones

content-type
application/json

x-session-token
{{token}}
Completar con el token asignado a su usuario. Tener en cuenta que en este esquema de autenticación no debe agregar el termino "bearer" antes del token.

operation
1005
Completar con el número de operación.

En esta imagen se muestra como configurar la consulta:

Esta operación admite los siguientes parámetros de forma opcional:

Párametro
Ejemplo
Observaciones

offset
0

Párametro utilizado para la paginación. Indica a partir de qué registro se desea consultar. El valor por defecto es 0 (cero), si no se especifica otro tomará ese valor.

limit
400

Parámetro utilizado para la paginación. Indica la cantidad máxima de registro que devolverá la consulta. Rango válido: 1 a 400, si no se especifica o se pone un valor inválido se tomará por defecto 400.

sku
DP-01S

Código del material a consultar.

brand
L99

Código de la marca.

category
819947

Código de la categoría.

Tener en cuenta que los parámetros admiten valores únicos. A continuación se muestra imagen de parámetros de consulta opcionales :

Estos parámetros se pueden combinar de distintas maneras según la información que desea obtener.
Así mismo, se pude consultar una lista de materiales específica enviándola en el body de la solicitud.

A continuación, detallamos algunos ejemplos de consultas posibles:

Caso 1: Consulta catálogo completo

Solicitud:

En este caso no se envía ningún parámetro adicional en la URL, pero se recomienda utilizar los parámetros de paginación en caso de que el total de registros supere los 400.
De no enviarlos tomarán el valor por defecto y siempre devolverá los primeros 400 registros.
La consulta solo devolverá registros con stock.

Ejemplo de URL con paginación:      https://api.pcarts.com/operations?offset=0&limit=400

Respuesta:

Si la consulta se efectuó exitosamente deberá devolver un JSON con la lista de productos:

BODY
Observaciones

{
    "Products": [
        {
            "sku": "193V5LHSB2/55",
            "sku_desc": "MONITOR PHILIPS 19 HDMI",
            "brand": "P8",
            "brand_desc": "PHILIPS",
            "category": "040114",
            "category_desc": "MONITORES LCD",
            "sku_date_created": "20190301",
            "tax_ii_rate": 0,
            "tax_iva_rate": 21,
            "images": [
                "https://mcstaging.pcarts.com/media/catalog/product/cache/d0392927a34ce148b44221affce38ec3/m/o/monitor-19-philips-xxxx.jpg"
            ]
        },
        {
            "sku": "407-BBOC",
            "sku_desc": "SFP+ 10GbE Module for N3000/S3100 Series",
            "brand": "D4",
            "brand_desc": "DELL",
            "category": "280226",
            "category_desc": "ACCESORIOS SERVER",
            "sku_date_created": "20191015",
            "tax_ii_rate": 0,
            "tax_iva_rate": 21,
            "images": [
                "https://mcstaging.pcarts.com/media/catalog/product/cache/d0392927a34ce148b44221affce38ec3/4/0/407-bxxc_x.jpg"
            ]
        },
        {
            "sku": "407-BBOS",
            "sku_desc": "Dell SFP+ LR Optic, 10GbE Transceiver",
            "brand": "D4",
            "brand_desc": "DELL",
            "category": "280226",
            "category_desc": "ACCESORIOS SERVER",
            "sku_date_created": "20180108",
            "tax_ii_rate": 0,
            "tax_iva_rate": 21,
            "images": [
                "https://mcstaging.pcarts.com/media/catalog/product/cache/d0392927a34ce148b44221affce38ec3/4/0/407-xxxx.jpg"
            ]
        },
        {
            "sku": "540-BBUN",
            "sku_desc": "Broadcom 57412 DP 10GB SFP+, Full Height",
            "brand": "D4",
            "brand_desc": "DELL",
            "category": "150057",
            "category_desc": "PLACAS DE RED",
            "sku_date_created": "20180507",
            "tax_ii_rate": 10.5,
            "tax_iva_rate": 10.5
        }
    ],
        "Paging": {
        "offset": 0,
        "limit": 400,
        "total": 4
    }
}
Ejemplo de catálogo (materiales con stock)

En el nodo Paging se indicará la cantidad total de registros que devuelve la consulta, así como los valores de offset y limit aplicados.
Recordar que al no enviar ningún parámetro se tomarán los valores por defecto.

Caso 2: Consulta catálogo por marca y/o categoría

Solicitud:

Utilizar los parámetros “brand” y/o “category” para consultar los materiales de una marca o de un grupo de artículo específico.
También se puede enviar ambos y devolverá los materiales que cumplan ambos criterios.
La consulta solo devolverá registros con stock.
Se recomienda utilizar los parámetros de paginación en caso de que el total de registros supere los 400.
De no enviarlos tomarán el valor por defecto y siempre devolverá los primeros 400 registros.

Ejemplo de URL por almacén:   https://api.pcarts.com/operations?brand=I4&category=060015

Respuesta:

Si la consulta se efectuó exitosamente deberá devolver un JSON con la lista de productos:

BODY
Observaciones

{
    "Products": [
        {
            "sku": "AD7480ACABBOX",
            "sku_desc": "MICRO AMD APU A6 7480 FM2",
            "brand": "A14",
            "brand_desc": "AMD",
            "category": "060015",
            "category_desc": "PROCESADORES - DSK",
            "sku_date_created": "20190308",
            "tax_ii_rate": 0,
            "tax_iva_rate": 10.5,
            "images": [
                "https://mcstaging.pcarts.com/media/catalog/product/cache/d0392927a34ce148b44221affce38ec3/m/i/micro-amd-apu-a6-7480-xxx.jpg"
            ]
        },
        {
            "sku": "AD9500AGABBOX",
            "sku_desc": "MICRO AMD APU A6 9500 AM4",
            "brand": "A14",
            "brand_desc": "AMD",
            "category": "060015",
            "category_desc": "PROCESADORES - DSK",
            "sku_date_created": "20171130",
            "tax_ii_rate": 0,
            "tax_iva_rate": 10.5,
            "images": [
                "https://mcstaging.pcarts.com/media/catalog/product/cache/d0392927a34ce148b44221affce38ec3/a/d/ad9500agaxxxx.jpg"
            ]
        },
        {
            "sku": "AD9600AGABBOX",
            "sku_desc": "MICRO AMD APU A8 9600 AM4",
            "brand": "A14",
            "brand_desc": "AMD",
            "category": "060015",
            "category_desc": "PROCESADORES - DSK",
            "sku_date_created": "20170831",
            "tax_ii_rate": 0,
            "tax_iva_rate": 10.5,
            "images": [
                "https://mcstaging.pcarts.com/media/catalog/product/cache/d0392927a34ce148b44221affce38ec3/m/i/micro-amd-apu-a8-xxxx-am4.jpg"
            ]
        },
        {
            "sku": "YD3000C6FHBOX",
            "sku_desc": "MICRO AMD ATHLON 3000G AM4",
            "brand": "A14",
            "brand_desc": "AMD",
            "category": "060015",
            "category_desc": "PROCESADORES - DSK",
            "sku_date_created": "20191127",
            "tax_ii_rate": 0,
            "tax_iva_rate": 10.5,
            "images": [
                "https://mcstaging.pcarts.com/media/catalog/product/cache/d0392927a34ce148b44221affce38ec3/a/m/amd-athlon-3xxx.jpg"
            ]
        }
    ],
    "Paging": {
        "offset": 0,
        "limit": 400,
        "total": 8
    }
}
Ejemplo de listado catálogo solo con materiales que concuerdan con los parámetros solicitados.

En el nodo Paging se indicará la cantidad total de registros que devuelve la consulta, así como los valores de offset y limit aplicados.
Recordar que al no enviar ningún parámetro se tomarán los valores por defecto.

Caso 3: Consulta catálogo por listado de materiales

Solicitud:

Para consultar catálogo solo con ciertos materiales específicos, se puede enviar el listado de los materiales en el body de la solicitud.
Esta opción acepta hasta 20 materiales en la consulta.

Ejemplo de URL:   https://api.pcarts.com/operations

BODY
Observaciones

{
    "Products": {
        "sku": [
            "100-100000589WOF",
            "100-100000931BOX",
            "WD10EZEX"
        ]
    }
}

Se enviará el body con el array Products, detallando los códigos de los materiales a consultar.

Respuesta:

Si la consulta se efectuó exitosamente deberá devolver un JSON con la lista de registros correspondiente a esos materiales.

BODY
Observaciones

{
    "Products": [
        {
            "sku": "AD9500AGABBOX",
            "sku_desc": "MICRO AMD APU A6 9500 AM4",
            "brand": "A14",
            "brand_desc": "AMD",
            "category": "060015",
            "category_desc": "PROCESADORES - DSK",
            "sku_date_created": "20171130",
            "tax_ii_rate": 0,
            "tax_iva_rate": 10.5,
            "images": [
                "https://mcstaging.pcarts.com/media/catalog/product/cache/d0392927a34ce148b44221affce38ec3/a/d/ad9500agabbox.jpg"
            ]
        },
        {
            "sku": "WD10EZEX",
            "sku_desc": "HD 1TB SATA III WD BLUE",
            "brand": "W2",
            "brand_desc": "WESTERN DIGITAL",
            "category": "070168",
            "category_desc": "DISCOS RIG HDD SATA",
            "sku_date_created": "20170128",
            "tax_ii_rate": 0,
            "tax_iva_rate": 10.5,
            "images": [
                "https://mcstaging.pcarts.com/media/catalog/product/cache/d0392927a34ce148b44221affce38ec3/8/1/81gdioobqxl._sl1500_.jpg"
            ]
        },
        {
            "sku": "YD3000C6FHBOX",
            "sku_desc": "MICRO AMD ATHLON 3000G AM4",
            "brand": "A14",
            "brand_desc": "AMD",
            "category": "060015",
            "category_desc": "PROCESADORES - DSK",
            "sku_date_created": "20191127",
            "tax_ii_rate": 0,
            "tax_iva_rate": 10.5,
            "images": [
                "https://mcstaging.pcarts.com/media/catalog/product/cache/d0392927a34ce148b44221affce38ec3/a/m/amd-athlon-3000g.jpg"
            ]
        }
    ],
    "Paging": {
        "offset": 0,
        "limit": 400,
        "total": 3
    }
}
Ejemplo de catálogo de materiales consultados.

Caso 4: Consulta catálogo de un material específico

Solicitud:

Si solo necesita consultar un material específico, puede indicar el código del mismo en el parámetro "sku".

Ejemplo de URL por material: https://api.pcarts.com/operations?sku=BX8071514400

Respuesta:

Si la consulta se efectúo exitosamente deberá devolver un JSON con la información del producto:

BODY
Observaciones

{
    "Products": [
        {
            "sku": "WD10EZEX",
            "sku_desc": "HD 1TB SATA III WD BLUE",
            "brand": "W2",
            "brand_desc": "WESTERN DIGITAL",
            "category": "070168",
            "category_desc": "DISCOS RIG HDD SATA",
            "sku_date_created": "20170128",
            "tax_ii_rate": 0,
            "tax_iva_rate": 10.5,
            "images": [
                "https://mcstaging.pcarts.com/media/catalog/product/cache/d0392927a34ce148b44221affce38ec3/8/1/81gdioobqxl._sl1500_.jpg"
            ]
        }
    ],
    "Paging": {
        "offset": 0,
        "limit": 400,
        "total": 1
    }
}
Devuelve Json con detalles del material consultado.

Los casos arriba descriptos son a modo ejemplificador, los parámetros se pueden combinar según la necesidad.
En caso de combinar la consulta de material por parámetro (que solo admite un valor) con el envío de un listado de materiales en el body de la solicitud,
la respuesta contendrá la información de ambos, tanto el material del parámetro como del listado.
En caso de consultar por listado de materiales tener en cuenta que devolverá detalle de hasta 20 materiales.

Parámetro Header	Valor	Observaciones
content-type	application/json
x-session-token	{{token}}	Completar con el token asignado a su usuario. Tener en cuenta que en este esquema de autenticación no debe agregar el termino "bearer" antes del token.
operation	1005	Completar con el número de operación.

Párametro	Ejemplo	Observaciones
offset	0	Párametro utilizado para la paginación. Indica a partir de qué registro se desea consultar. El valor por defecto es 0 (cero), si no se especifica otro tomará ese valor.
limit	400	Parámetro utilizado para la paginación. Indica la cantidad máxima de registro que devolverá la consulta. Rango válido: 1 a 400, si no se especifica o se pone un valor inválido se tomará por defecto 400.
sku	DP-01S	Código del material a consultar.
brand	L99	Código de la marca.
category	819947	Código de la categoría.

BODY	Observaciones
{ "Products": { "sku": [ "100-100000589WOF", "100-100000931BOX", "WD10EZEX" ] } }	Se enviará el body con el array Products, detallando los códigos de los materiales a consultar.