URL: https://api.pcarts.com/operations
Método: POST.
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
1010
Completar con el número de operación que desea realizar.
En esta imagen se muestra como configurar la consulta:
Esta operación permite cargar ordenes enviando en el body los datos requeridos y especificando la operación en el header, como en el resto de operaciones.
Se admite una orden por cada solicitud y recibirá en la respuesta si fue exitosa la creación o si hay algún inconveniente con los datos enviados.
Caso 1: Carga de órden con datos mínimos
Solicitud:
Puede optar por enviar la solicitud de una nueva órden detallando únicamente los códigos de productos y cantidades en el body , siempre que respete el formato de JSON indicado.
Los datos adicionales que no se envien, tomarán los valores por defecto que tiene su empresa si la carga del pedido es exitosa.
Ejemplo URL: https://api.pcarts.com/operations
BODY Observaciones {
"order": {
"products": [
{
"sku": "MT-K835A",
"qty": "1"
},
{
"sku": "MT-PSU500",
"qty": "2"
}
]
}
}
Se enviará el body con el array Products, detallando los códigos de los materiales y cantidad de cada uno a incluir en la orden.
Respuesta:
Si la carga se efectuó exitosamente devolverá un mensaje de confirmación, caso contrario un mensaje que indique el problema.
BODY Observaciones {
"operation": 12,
"code": "OK",
"details": [
{
"message": "Se ha generado correctamente la operación. Estamos procesando su pedido. "
}
]
}
En caso de error, el JSON devolverá también el código de operación, pero con "code": "FAIL", y un mensaje informativo sobre el problema en "details".
Caso 2: Carga de órden incluyendo información opcional
Solicitud:
La informacón adicional le permitirá modificar los valores por defecto para ciertos pedidos si lo necesita. Campos optativos:
- pay_term_code: Código identificador de la condición de pago. Consulte la operación 1015 para obtener el listado de valores aplicable a su empresa.
- address_id: Código de Dirección de Entrega. Consulte la operación 1014 para obtener el listado de valores aplicable a su empresa.
Incluya en el JSON del Body los campos que necesite especificar como se muestra en el ejemplo.
Ejemplo URL : https://api.pcarts.com/operations
BODY Observaciones {
"order": {
"pay_term_code": "Y071",
"address_id": "6000013413",
"products": [
{
"sku": "MT-K835A",
"qty": "2"
},
{
"sku": "MT-PSU500",
"qty": "3"
}
]
}
}
Se enviará el JSON en el body detallando los campos de información optativa y el array Products, detallando los códigos de los materiales y cantidad de cada uno a incluir en la orden.
Respuesta:
Si la carga se efectuó exitosamente devolverá un mensaje de confirmación, caso contrario un mensaje que indique el problema.
BODY
Observaciones {
"operation": 16,
"code": "OK",
"details": [
{
"message": "Se ha generado correctamente la operación. Estamos procesando su pedido."
}
]
}En caso de error, el JSON devolverá también el código de operación, pero con "code": "FAIL", y un mensaje informativo sobre el problema en "details".
Los casos arriba descriptos son a modo ejemplificador, los campos opcionales se pueden combinar según la necesidad.
Validaciones de datos
Al recibir la solicitud se realizarán
una serie de validaciones básicas de los datos enviados, a
continuación se indican los mensajes que devolverá en caso
de fallar:
Por otros mensajes puede consultar la sección casos de error frecuentes.
Mensaje de Error
Motivo "message":"No se encontraron items en la orden."
"message":"El material DIR-600 se encuentra duplicado."
"message":"El material DIR-600 es inexistente."
"message":"El material DIR-600 no posee stock."
"message":"La condición de pago Y077 es inválida."
"message":"La dirección de entrega 60005464654 es inválida."