Invoices Detail

Detalle de factura

Obtiene información de un documento en base al FOLIO enviado.

Nombre

Tipo y longitud o rango de dato

Descripción

Requerido

Default

HOST

URL

Se indicará de acuerdo el ambiente

donde será consumido el servicio:

Producción:

https://api.next-cloud.mx

Staging:

https://api.axolote.next-cloud.mx

Sí

N/A

Resource URL

GET HOST/v1/providers/invoices/:folio/

Parámetros:

folio (int) – Folio del documento factura.

Encabezados de solicitud:

Authorization – Token del usuario.
Content-Type – Define el formato en el que se envian los datos por el body.

Objeto JSON de respuesta:

created_at (string) – Fecha de creación del documento.
status (string) – Clave del estado.
reference_document (string) – Clave de referencia del documento factura.
reference_folio (int) – Folio de referencia de la factura.
provider (obj) – Objeto de proveedores.
due_at (string) – Fecha de vencimiento del documento.
balance (float) – Saldo del documeto.
user (obj) – Objeto de usuario.
total (float) – Total del documento.
applications (obj) – Objeto de aplicaciones (Cobros).

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 – El embarque no existe.

provider object:

Objeto JSON de respuesta:

id (int) – Identificador del proveedore.
bussines_name (string) – Razón social del proveedore.

provider object:

Objeto JSON de respuesta:

id (int) – Identificador del usuario.
username (string) – Nombre del usuario.

Example request

GET /v1/providers/invoices/916/ HTTP/1.1
Host: api.next-cloud.mx
Accept: application/json
Content-Type: application/json
Authorization: Token ( token del usuario )

Example Response

HTTP/1.1 200 OK
Vary: Accept
Content-Type: application/json
Allow: GET

{
    "created_at": "2025-08-31T00:00:00Z",
    "status": "N",
    "reference_document": "FACPS",
    "reference_folio": "qwerty199",
    "provider": {
        "id": 1,
        "bussines_name": "1385987525"
    },
    "due_at": "2025-09-30T00:00:00Z",
    "balance": "1218.00",
    "user": {
        "id": 509,
        "username": "mmarco    "
    },
    "currency": "MN",
    "parity": "1.0000",
    "amount": 1100.0,
    "discount": 50.0,
    "tax": 168.0,
    "total": "1218.00",
    "observations": "",
    "concepts": [
        {
            "concept": "ENERGIA ELECTRICA",
            "amount": 600.0
        },
        {
            "concept": "AGUA",
            "amount": 500.0
        }
    ]
}