Obtener una factura por ID

GET

/invoices/{id}

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

• Development environment (dominio custom)
• QA environment
• Production environment
• Development environment (legacy — execute-api URL directo)

Devuelve la factura junto con un objeto trip enriquecido (cliente, conductor, vehículo del viaje asociado) para render directo en el frontend sin llamadas adicionales.

Authorizations

• cognitoAuth

Parameters

Path Parameters

id

required

string format: uuid

ID de la factura (UUID)

Query Parameters

teamId

required

string format: uuid

ID del equipo (UUID)

Responses

200

Factura con datos de viaje/cliente/conductor/vehículo enriquecidos

Media typeapplication/json

object

id

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

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

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

trip

object

id

string

client

object

id

string

name

string

rfc

string

driver

object

id

string

name

string

photoUrl

string

vehicle

object

id

string

plate

string

brand

string

model

string

imageUrl

string

Example

{
  "status": "DRAFT",
  "paymentMethod": "PUE",
  "items": [
    {
      "productKey": "78101500",
      "quantity": 1,
      "unitKey": "E48",
      "taxRate": 0.16
    }
  ],
  "cartaPorte": {
    "origen": {
      "tipoUbicacion": "Origen",
      "domicilio": {
        "pais": "MEX"
      }
    },
    "destino": {
      "tipoUbicacion": "Origen",
      "domicilio": {
        "pais": "MEX"
      }
    },
    "mercancias": [
      {
        "cantidad": 1,
        "claveUnidad": "KGM"
      }
    ]
  }
}

400

Solicitud inválida

Media typeapplication/json

object

error

required

string

message

string

field

string

Example

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

403

Sin permisos

Media typeapplication/json

object

error

required

string

message

string

field

string

Example

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

404

Recurso no encontrado

Media typeapplication/json

object

error

required

string

message

string

field

string

Example

{
  "error": "Not found",
  "message": "Resource not found"
}