Balances Detail

Detalle de factura

Obtiene información de un documento en base al ID 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://stg-api.next-cloud.mx

Sí

N/A

Resource URL

GET HOST/v1/customers/balances/:id/

Parámetros:

id (int) – Identificador 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:

id (int) – Identificador del documento factura.
document (string) – Clave del documento factura.
folio (int) – Folio de la factura.
serie (string) – Serie de factura.
created_at (string) – Fecha de creación del documento.
total (float) – Total del documento.
balance (float) – Saldo del documeto.
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.

applications object:

Objeto JSON de respuesta:

created_at (string) – Fecha de creación del documento.
amount (float) – Total del documento.
currency (string) – Moneda del documento.
status (string) – Estado del documento.
account (obj) – Objeto detalle del documento (Cobros).

account object:

Objeto JSON de respuesta:

document (string) – Clave del documento factura.
folio (int) – Folio de la factura.
created_at (string) – Fecha de creación del documento.
total (float) – Total del documento.
balance (float) – Saldo del documeto.

Example request

GET /v1/customers/balances/9438314/ 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

{
    "id": 9438314,
    "document": "FACTC",
    "folio": 3368068,
    "serie": "E",
    "created_at": "2025-08-01T07:51:19.810000Z",
    "total": "1853.56",
    "balance": "1853.56",
    "applications": [
        {
            "created_at": "2025-08-01T00:00:00Z",
            "amount": "1853.56",
            "currency": "MN",
            "status": "N",
            "account": {
                "document": "COBXT",
                "folio": 1549379,
                "total": "1853.56",
                "balance": "0.00",
                "created_at": "2025-08-01T00:09:30Z"
            }
        }
    ]
}