Listar facturas del equipo

GET

/invoices

const url = 'https://api.dev.lade.com.mx/invoices?teamId=2489E9AD-2EE2-8E00-8EC9-32D5F69181C0&page=1&limit=10&status=DRAFT';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url 'https://api.dev.lade.com.mx/invoices?teamId=2489E9AD-2EE2-8E00-8EC9-32D5F69181C0&page=1&limit=10&status=DRAFT' \
  --header 'Authorization: Bearer <token>'

Lista las facturas (CFDI) del equipo con filtros y paginación.

Authorizations

cognitoAuth

Parameters

Query Parameters

teamId

required

string format: uuid

ID del equipo (UUID)

page

integer

default: 1

limit

integer

default: 10 <= 50

Tope 50

status

DRAFT: borrador editable (creado automáticamente al crear un viaje). PENDING: timbrado en curso (lock atómico). VALID: timbrada. CANCELLED/CANCELLED_PENDING: cancelada (inmediata o en proceso ante el SAT). ERROR: falló el último intento de timbrado, editable de nuevo.

string

Allowed values: DRAFT PENDING VALID CANCELLED CANCELLED_PENDING ERROR

tripId

string format: uuid

clientId

string format: uuid

Responses

200

Lista paginada de facturas

application/json

object

invoices

Array<object>

object

string format: uuid

teamId

string format: uuid

tripId

string format: uuid

clientId

string

nullable

clientName

string

nullable

facturapiId

string

nullable

folio

string

nullable

series

string

nullable

status

string

Allowed values: DRAFT PENDING VALID CANCELLED CANCELLED_PENDING ERROR

subtotal

number

taxAmount

number

total

number

paymentForm

Clave SAT c_FormaPago, ej. 03=Transferencia

string

paymentMethod

string

Allowed values: PUE PPD

cfdiUse

Clave SAT c_UsoCFDI, ej. G03=Gastos en general

string

items

Array<object>

object

description

required

string

<= 1000 characters

productKey

Clave de producto/servicio SAT (catálogo c_ClaveProdServ)

string

default: 78101500 <= 10 characters

quantity

integer

default: 1 >= 1

unitKey

Clave de unidad SAT (catálogo c_ClaveUnidad)

string

default: E48 <= 10 characters

price

required

number

> 0

taxRate

number

default: 0.16 <= 1

cartaPorte

Datos del complemento Carta Porte 3.1 que el frontend arma para PUT /invoices/{id}. El backend los combina con los datos del vehículo/conductor del viaje para construir el complemento completo que se envía a Facturapi.

object

totalDistRec

required

Distancia total recorrida en km

number

> 0

origen

required

object

tipoUbicacion

string

Allowed values: Origen Destino

rfc

required

string

<= 13 characters

nombre

required

string

<= 300 characters

fechaHora

required

ISO datetime, ej. 2025-12-18T05:00:00

string

distancia

Km, solo aplica en Destino

number

nullable

domicilio

required

object

calle

string

nullable

codigoPostal

required

string

colonia

Código de 4 dígitos, catálogo SAT

string

nullable

estado

required

Código de 3 letras SAT, ej. NLE, JAL, MEX

string

municipio

string

nullable

pais

string

default: MEX

destino

required

object

tipoUbicacion

string

Allowed values: Origen Destino

rfc

required

string

<= 13 characters

nombre

required

string

<= 300 characters

fechaHora

required

ISO datetime, ej. 2025-12-18T05:00:00

string

distancia

Km, solo aplica en Destino

number

nullable

domicilio

required

object

calle

string

nullable

codigoPostal

required

string

colonia

Código de 4 dígitos, catálogo SAT

string

nullable

estado

required

Código de 3 letras SAT, ej. NLE, JAL, MEX

string

municipio

string

nullable

pais

string

default: MEX

mercancias

required

Array<object>

>= 1 items

object

bienesTransp

required

Clave SAT de bienes transportados

string

descripcion

required

string

cantidad

number

default: 1

claveUnidad

string

default: KGM

pesoKg

required

number

> 0

configVehicular

string

nullable

pesoBrutoVehicular

number

nullable

permSCT

string

nullable

numPermisoSCT

string

nullable

aseguradora

string

nullable

placaRemolque

string

nullable

subtipoRemolque

string

nullable

pdfUrl

string

nullable

xmlUrl

string

nullable

notes

string

nullable

hasCartaPorte

boolean

errorMessage

string

nullable

issuedAt

string format: date-time

createdAt

string format: date-time

updatedAt

string format: date-time

pagination

object

total

integer

page

integer

limit

integer

hasMore

boolean

Example

{
  "invoices": [
    {
      "id": "990e8400-e29b-41d4-a716-446655440004",
      "teamId": "550e8400-e29b-41d4-a716-446655440000",
      "tripId": "880e8400-e29b-41d4-a716-446655440003",
      "status": "VALID",
      "total": 11600
    }
  ],
  "pagination": {
    "total": 1,
    "page": 1,
    "limit": 10,
    "hasMore": false
  }
}

400

Solicitud inválida

application/json

object

error

required

string

message

string

field

string

Example

{
  "error": "Validation failed",
  "field": "email",
  "message": "Invalid email format"
}

403

Sin permisos

application/json

object

error

required

string

message

string

field

string

Example

{
  "error": "Forbidden",
  "message": "You don't have permission to access this resource"
}