API PCARTS

API PC ARTS

Operación 1004: Consulta de Stock y Precio

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
1004
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:

Parámetro
Ejemplo observaciones

offset 0

Parámetro 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 se tomará ese valor.

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

sku
WD10EZEX
Código del material a consultar. Admite un único valor.

sku_date_updated_from
2025-07-07T11:01:45

Permite consultar materiales con última modifiación posterior a la fecha y hora especificada.

sku_date_updated_to 2025-07-06T11:01:45
Permite consultar materiales con última modifiación anterior a la fecha y hora especificada.

Parámetro	Ejemplo	observaciones
offset	0	Parámetro 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 se tomará ese valor.
limit	1000	Parámetro utilizado para la paginación. Indica la cantidad máxima de registro que devolverá la consulta. Rango válido: 1 a 1000, si no se especifica o se pone un valor inválido se tomará el valor por defecto 1000
sku	WD10EZEX	Código del material a consultar. Admite un único valor.
sku_date_updated_from	2025-07-07T11:01:45	Permite consultar materiales con última modifiación posterior a la fecha y hora especificada.
sku_date_updated_to	2025-07-06T11:01:45	Permite consultar materiales con última modifiación anterior a la fecha y hora especificada.

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

También 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 de stock de materiales completo

Solicitud:

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

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

Respuesta:

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

BODY
Observaciones

{
    "Products": [
        {
            "sku": "02-SSC-6908",
            "price": 2714.78,
            "stock": 1,
            "sku_date_updated": "2024-07-23T11:03:05"
        },
        {
            "sku": "02-SSC-8829",
            "price": 857.48,
            "stock": 1,
            "sku_date_updated": "2024-07-23T11:03:05"
        },
        {
            "sku": "100-100000065BOX",
            "price": 217.07,
            "stock": 2,
            "sku_date_updated": "2024-07-30T15:54:20"
        },
        {
            "sku": "100-100000263BOX",
            "price": 246.21,
            "stock": 5,
            "sku_date_updated": "2024-07-30T11:35:12"
        }
    ],
    "Paging": {
        "offset": 0,
        "limit": 4,
        "total": 249
    }
}
Ejemplo de listado de materiales.

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 stock de listado de materiales.

Solicitud:

Para consultar el stock solo de ciertos materiales específicos, se puede enviar el listado de los materiales en formto JSON 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": [
            "00000000000018-1002",
            "407-BBO-C",
            "WD10EZ-EX"
        ]
    }
}
Se enviará el body con el nodo Products y dentro el arrary 'sku' 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": "WD10EZ-EX",
            "price": 59.39,
            "stock": 872,
            "sku_date_updated": "2024-07-30T11:40:03.367"
        }
    ],
    "Paging": {
        "offset": 0,
        "limit": 1000,
        "total": 1
    }
}
Ejemplo de listado de materiales consultados.

En la solicitud se incluyó 3 materiales, pero solo uno se incluye en la respuesta, porque el otro no tiene stock.



Caso 3: Consulta de stock de un material específico

Solicitud:

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

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

Respuesta:

Si la consulta se efectuó exitosamente deberá devolver un JSON con el producto solicitado:

BODY
Observaciones

{
    "Products": [
        {
            "sku": "WD10EZ-EX",
            "price": 59.39,
            "stock": 872,
            "sku_date_updated": "2024-07-30T11:40:03.367"
        }
    ],
    "Paging": {
        "offset": 0,
        "limit": 1000,
        "total": 1
    }
}
Al consultar por un material específico devuelve el stock del mismo, si no tiene stock no devolverá el array products.



Caso 4: Consulta materiales modificados desde una fecha definida.

Solicitud:

Si quiere consultar los materiales que han sufrido modificaciones en su stock o precio desde una fecha determinada (por ejemplo desde la última consulta realizada) puede utilizar el parámetro 'sku_date_updated_from'.

Ejemplo de URL por material: https://api.pcarts.com/operations?sku_date_updated_from =2025-07-06T11:01:45
Respuesta:

Si la consulta se efectuó exitosamente deberá devolver un JSON con los productos que sufrieron modificaciones luego de la fechay hora del parámetro:

BODY
Observaciones

{
    "Products": [
        {
            "sku": "193V5LHSB2/55",
            "price": 110.92,
            "stock": 40,
            "sku_date_updated": "2025-07-07T12:36:59"
        },
        {
            "sku": "MT-PSU500",
            "price": 1.31,
            "stock": 7491,
            "sku_date_updated": "2025-07-07T17:59:17"
        },
        {
            "sku": "WD10EZEX",
            "price": 36.71,
            "stock": 330,
            "sku_date_updated": "2025-07-10T12:22:52"
        }
    ],
    "Paging": {
        "offset": 0,
        "limit": 1000,
        "total": 3
    }
}
Ejemplo de listado de materiales con fecha de última modificación posterior a la indicada en el parámetro.

También puede combinar en la consulta con el parámetro 'sku_date_updated_to' para definir un rango de fechas y/o horas mas acotado.

Los casos arriba descriptos son a modo ejemplificador, los parámetros se pueden combinar según la necesidad.
Se puede utilizar el envio de un listado de materiales y también el parámetro por material, o realizar consultas por fechas de modificación.

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	1004	Completar con el número de operación.

BODY	Observaciones
{ "Products": { "sku": [ "00000000000018-1002", "407-BBO-C", "WD10EZ-EX" ] } }	Se enviará el body con el nodo Products y dentro el arrary 'sku' detallando los códigos de los materiales a consultar.

BODY	Observaciones
{ "Products": [ { "sku": "WD10EZ-EX", "price": 59.39, "stock": 872, "sku_date_updated": "2024-07-30T11:40:03.367" } ], "Paging": { "offset": 0, "limit": 1000, "total": 1 } }	Ejemplo de listado de materiales consultados. En la solicitud se incluyó 3 materiales, pero solo uno se incluye en la respuesta, porque el otro no tiene stock.