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:
 
Query Parameters:
 
  • start_date (date) – Fecha inicial de consulta (yyyy-MM-dd).
  • end_date (date) – Fecha final de consulta (yyyy-MM-dd).
Status Codes:
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>