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 https://api.next-cloud.mx/v1/purchase/order/(int: order_id).(format)

Parámetros:

order_id – Folio de la orden.
format – json o xml.

Encabezados de solicitud:

Authorization – Token del usuario.
Authorization – Token del usuario.

Parámetros de consulta:

start_date (date) – Fecha inicial de consulta (yyyy-MM-dd).
end_date (date) – Fecha final de consulta (yyyy-MM-dd).

Códigos de Status:

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.

Objeto JSON de respuesta:

status (string) – Estado de la orden.
folio (int) – Folio de la orden.
document (string) – Tipo del documento.
observation (string) – Observaciones.
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 de la orden.
amount (float) – Importe sin impuestos.
contact (string) – Contacto del proveedor.
details (array) – Lista de artículos recibidos.
shipment (int) – Número de embarque.
provider (string) – Nombre del proveedor.
warehouse (string) – Nombre del almacén.
total (float) – Importe total (Con impuestos).
order_number (string) – Número de orden (número de pedido)

details

Objeto JSON de respuesta:

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 v1/purchase/order/25.json HTTP/1.1
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 v1/purchase/order/0.json?start_date=2019-01-02&end_date=2019-01-02 HTTP/1.1
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 v1/purchase/order/25.xml HTTP/1.1
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 v1/purchase/order/0.xml?start_date=2019-01-02&end_date=2019-01-02 HTTP/1.1
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>