PURCHASE ORDERS¶
Get information about one or many purchase orders¶
Obtiene información y el detalle de artículos recibidos de una o varias ordenes
Resource URL¶
-
GET
http://api.next-cloud.mx/v1/purchase/order/
(int: order_id).
(format)¶ Parameters: - order_id – Folio de la orden.
- format – json o xml.
Request Headers: - Authorization – Token del usuario.
Query Parameters: - start_date (date) – Fecha inicial de consulta (yyyy-MM-dd).
- end_date (date) – Fecha final de consulta (yyyy-MM-dd).
Status Codes: - 200 OK – Ningún error.
- 400 Bad Request – Algún parámetro es incorrecto.
- 401 Unauthorized – Token no válido o no enviado.
- 404 Not Found – Cliente no localizado o el almacen no tiene existencias.
- 500 Internal Server Error – Error.
Response JSON Array of Objects: - status (string) – Estado actual de la orden.
- folio (int) – Número de folio de la orden.
- document (string) – Tipo del documento.
- observation (string) – Observaciones de la orden.
- discount (float) – Descuento aplicado.
- creation (date) – Fecha de emisión (dd/mm/yyyy).
- tax (float) – Impuesto aplicado.
- delivery (date) – Fecha de entrega (dd/mm/yyyy).
- currency (string) – Moneda en la que se expresa la orden.
- amount (float) – Importe antes de impuestos.
- contact (string) – Contacto del proveedor.
- details (array) – Lista de artículos recibidos en la orden.
- shipment (int) – Número de embarque.
- provider (string) – Nombre del proveedor.
- warehouse (string) – Nombre del almacén donde se recibe la orden.
- total (float) – Importe total (Con impuestos).
- order_number (string) – Número de orden (número de pedido)
details
Response JSON Object: - sku (string) – SKU del artículo.
- received (float) – Cantidad recibida del artículo.
- sku_description (string) – Descripción del artículo.
- requested (float) – Cantidad solicitada del artículo.
Example request (one order)¶
GET http://api.next-cloud.mx/v1/purchase/order/25.json
Host: api.next-cloud.mx
Accept: application/json
Authorization: Token (token del usuario)
Example Response¶
HTTP/1.1 200 OK
Vary: Accept
Content-Type: application/json
Allow: GET, OPTIONS
[
{
"status": "Recibida",
"folio": 25.0,
"document": "ORNAL",
"observation": null,
"discount": 0.0,
"creation": "09/03/2005",
"tax": 0.0,
"delivery": "09/03/2005",
"currency": "MN",
"amount": 0.0,
"contact": "++++********",
"details": [
{
"sku": "204361",
"received": 25.0,
"sku_description": "Tratamiento Homeopático Único Vida",
"requested": 25.0
}
],
"shipment": 0.0,
"provider": "225648903",
"warehouse": "Facturación",
"total": 0.0,
"order_number": null
}
]
Example request (date range)¶
GET http://api.next-cloud.mx/v1/purchase/order/0.json?start_date=2019-01-02&end_date=2019-01-02
Host: api.next-cloud.mx
Accept: application/json
Authorization: Token (token del usuario)
Example Response¶
HTTP/1.1 200 OK
Vary: Accept
Content-Type: application/json
Allow: GET, OPTIONS
[
{
"status": "Recibida",
"folio": 193726.0,
"document": "ORNAL",
"observation": null,
"discount": 0.0,
"creation": "02/01/2019",
"tax": 422.4,
"delivery": "07/01/2019",
"currency": "MN",
"amount": 2640.0,
"contact": "++++********",
"details": [
{
"sku": "91148797",
"received": 1.0,
"sku_description": "RELOJ CITIZEN C060756 CON PEDRERIA PARA DAMA PLATEADO",
"requested": 1.0
},
{
"sku": "91149062",
"received": 1.0,
"sku_description": "RELOJ CABALLERO CON MARCAS DE HORA GRANDES Y FECHADOR C060875 ACERO NEGRO",
"requested": 1.0
}
],
"shipment": 0.0,
"provider": "1759359157",
"warehouse": "Facturación",
"total": 3062.4,
"order_number": null
},
{
"status": "Recibida",
"folio": 193727.0,
"document": "ORNAL",
"observation": null,
"discount": 0.0,
"creation": "02/01/2019",
"tax": 654.08,
"delivery": "07/01/2019",
"currency": "MN",
"amount": 4088.0,
"contact": "++++********",
"details": [
{
"sku": "4173086",
"received": 1.0,
"sku_description": "ENFRIADOR DE VINOS CAVANOVA PARA 16 BOTELLAS NEGRO CV016",
"requested": 1.0
}
],
"shipment": 0.0,
"provider": "1478871537",
"warehouse": "Facturación",
"total": 4742.08,
"order_number": null
},
{
"status": "Recibida",
"folio": 193729.0,
"document": "ORNAL",
"observation": null,
"discount": 0.0,
"creation": "02/01/2019",
"tax": 2271.26,
"delivery": "07/01/2019",
"currency": "MN",
"amount": 14195.39,
"contact": "++++********",
"details": [
{
"sku": "91123075",
"received": 1.0,
"sku_description": "SET DE VASOS CROWN BACCARA CORTOS Y ALTOS 8 PIEZAS AKURE",
"requested": 1.0
},
{
"sku": "91126215",
"received": 1.0,
"sku_description": "SET DE TAZAS CROWN BACCARA 2 PIEZAS MULTICOLOR TEITI TR",
"requested": 1.0
},
{
"sku": "91127756",
"received": 1.0,
"sku_description": "SET DE TAZAS CROWN BACCARA 5 PIEZAS CAFE DILAN",
"requested": 1.0
},
{
"sku": "91127788",
"received": 1.0,
"sku_description": "CREPERA REDONDA CROWN BACCARA 28 CM NARANJADA RIVA NAR",
"requested": 1.0
}
],
"shipment": 0.0,
"provider": "450210941",
"warehouse": "Facturación",
"total": 16466.65,
"order_number": null
}
]
Example XML¶
Example request (one order)¶
GET http://api.next-cloud.mx/v1/purchase/order/25.xml
Host: api.next-cloud.mx
Accept: application/json
Authorization: Token (token del usuario)
Example Response¶
HTTP/1.1 200 OK
Vary: Accept
Content-Type: application/xml; charset=utf-8
Allow: GET, OPTIONS
<?xml version="1.0" encoding="utf-8"?>
<root>
<list-item>
<status>Recibida</status>
<folio>25.0</folio>
<document>ORNAL</document>
<observation></observation>
<discount>0.0</discount>
<creation>09/03/2005</creation>
<tax>0.0</tax>
<delivery>09/03/2005</delivery>
<currency>MN</currency>
<amount>0.0</amount>
<contact>++++********</contact>
<details>
<list-item>
<sku>204361</sku>
<received>25.0</received>
<sku_description>Tratamiento Homeopático Único Vida</sku_description>
<requested>25.0</requested>
</list-item>
</details>
<shipment>0.0</shipment>
<provider>225648903</provider>
<warehouse>Facturación</warehouse>
<total>0.0</total>
<order_number></order_number>
</list-item>
</root>
Example request (date range)¶
GET http://api.next-cloud.mx/v1/purchase/order/0.xml?start_date=2019-01-02&end_date=2019-01-02
Host: api.next-cloud.mx
Accept: application/json
Authorization: Token (token del usuario)
Example Response¶
HTTP/1.1 200 OK
Vary: Accept
Content-Type: application/xml; charset=utf-8
Allow: GET, OPTIONS
<?xml version="1.0" encoding="utf-8"?>
<root>
<list-item>
<status>Recibida</status>
<folio>193726.0</folio>
<document>ORNAL</document>
<observation></observation>
<discount>0.0</discount>
<creation>02/01/2019</creation>
<tax>422.4</tax>
<delivery>07/01/2019</delivery>
<currency>MN</currency>
<amount>2640.0</amount>
<contact>++++********</contact>
<details>
<list-item>
<sku>91148797</sku>
<received>1.0</received>
<sku_description>RELOJ CITIZEN C060756 CON PEDRERIA PARA DAMA PLATEADO</sku_description>
<requested>1.0</requested>
</list-item>
<list-item>
<sku>91149062</sku>
<received>1.0</received>
<sku_description>RELOJ CABALLERO CON MARCAS DE HORA GRANDES Y FECHADOR C060875 ACERO NEGRO</sku_description>
<requested>1.0</requested>
</list-item>
</details>
<shipment>0.0</shipment>
<provider>1759359157</provider>
<warehouse>Facturación</warehouse>
<total>3062.4</total>
<order_number></order_number>
</list-item>
<list-item>
<status>Recibida</status>
<folio>193727.0</folio>
<document>ORNAL</document>
<observation></observation>
<discount>0.0</discount>
<creation>02/01/2019</creation>
<tax>654.08</tax>
<delivery>07/01/2019</delivery>
<currency>MN</currency>
<amount>4088.0</amount>
<contact>++++********</contact>
<details>
<list-item>
<sku>4173086</sku>
<received>1.0</received>
<sku_description>ENFRIADOR DE VINOS CAVANOVA PARA 16 BOTELLAS NEGRO CV016</sku_description>
<requested>1.0</requested>
</list-item>
</details>
<shipment>0.0</shipment>
<provider>1478871537</provider>
<warehouse>Facturación</warehouse>
<total>4742.08</total>
<order_number></order_number>
</list-item>
<list-item>
<status>Recibida</status>
<folio>193729.0</folio>
<document>ORNAL</document>
<observation></observation>
<discount>0.0</discount>
<creation>02/01/2019</creation>
<tax>2271.26</tax>
<delivery>07/01/2019</delivery>
<currency>MN</currency>
<amount>14195.39</amount>
<contact>++++********</contact>
<details>
<list-item>
<sku>91123075</sku>
<received>1.0</received>
<sku_description>SET DE VASOS CROWN BACCARA CORTOS Y ALTOS 8 PIEZAS AKURE</sku_description>
<requested>1.0</requested>
</list-item>
<list-item>
<sku>91126215</sku>
<received>1.0</received>
<sku_description>SET DE TAZAS CROWN BACCARA 2 PIEZAS MULTICOLOR TEITI TR</sku_description>
<requested>1.0</requested>
</list-item>
<list-item>
<sku>91127756</sku>
<received>1.0</received>
<sku_description>SET DE TAZAS CROWN BACCARA 5 PIEZAS CAFE DILAN</sku_description>
<requested>1.0</requested>
</list-item>
</details>
<shipment>0.0</shipment>
<provider>450210941</provider>
<warehouse>Facturación</warehouse>
<total>16466.65</total>
<order_number></order_number>
</list-item>
</root>