#Facturas

Los CFDIs (facturas electrónicas) de una Fiscal Entity. Casi todos los endpoints CFDI requieren fiscalEntityId (fe_…) y están tenant-gated: si tu organización no tiene una conexión activa a ese RFC, la respuesta es 404, sin revelar si el RFC existe.

#El objeto Invoice

#Lista de CFDIs

Tabla principal de facturas. Devuelve los CFDIs de tu organización (vía conexión activa) que cumplen los filtros, de la más reciente a la más antigua, con paginación por cursor.

#Parámetros de consulta

curl "https://api.clarisfy.com/api/v1/cfdi/invoices?fiscalEntityId=fe_9a1c2b3d4e5f6071&from=2026-01-01T00:00:00Z&to=2026-07-01T00:00:00Z&status=vigente&pageSize=100" \
  -H "Authorization: Bearer clf_live_secret_9K3mZ1pQ7rTx8vB4nH6dLwYe"

{
  "items": [
    {
      "cfdi_uuid": "12345678-1234-1234-1234-123456789abc",
      "cfdi_type": "I",
      "cfdi_status": "vigente",
      "cfdi_version": "4.0",
      "issued_at": "2026-04-15T10:30:00+00:00",
      "series": "A",
      "folio": "00001",
      "emisor_rfc": "ACME920101AA1",
      "emisor_name": "ACME Corporativo SA",
      "receptor_rfc": "VECJ880326XYZ",
      "receptor_name": "Mi Empresa SA",
      "subtotal": "1000.00",
      "total": "1160.00",
      "currency": "MXN",
      "xml_available": true,
      "payment_method": "PPD",
      "payment_status": "sin_pagar",
      "outstanding_balance": "160.00"
    }
  ],
  "next_cursor": "eyJpc3N1ZWRfYXQiOiIyMDI2LTA0LTE1VDEwOjMwOjAwKzAwOjAwIiwiaWQiOjEyM30.abc123"
}

#Errores

#Detalle de un CFDI

Devuelve un CFDI específico por su folio fiscal, con relations (las relaciones del CFDI en ambos sentidos) y concepts (las líneas del comprobante, ordenadas por line_number), además de todos los campos del objeto Invoice.

#Parámetros

relations[]:

concepts[]:

curl "https://api.clarisfy.com/api/v1/cfdi/invoices/12345678-1234-1234-1234-123456789abc?fiscalEntityId=fe_9a1c2b3d4e5f6071" \
  -H "Authorization: Bearer clf_live_secret_9K3mZ1pQ7rTx8vB4nH6dLwYe"

{
  "cfdi_uuid": "12345678-1234-1234-1234-123456789abc",
  "cfdi_type": "I",
  "cfdi_status": "vigente",
  "cfdi_version": "4.0",
  "issued_at": "2026-04-15T10:30:00+00:00",
  "series": "A",
  "folio": "00001",
  "emisor_rfc": "ACME920101AA1",
  "emisor_name": "ACME Corporativo SA",
  "receptor_rfc": "VECJ880326XYZ",
  "receptor_name": "Mi Empresa SA",
  "subtotal": "1000.00",
  "total": "1160.00",
  "currency": "MXN",
  "xml_available": true,
  "payment_method": "PPD",
  "payment_status": "sin_pagar",
  "outstanding_balance": "160.00",
  "relations": [
    {
      "relation_type": "04",
      "related_uuid": "87654321-4321-4321-4321-cba987654321",
      "direction": "outgoing"
    }
  ],
  "concepts": [
    {
      "line_number": 1,
      "description": "Servicio profesional",
      "product_service_code": "01010101",
      "unit_code": "H87",
      "quantity": "1.00000000",
      "unit_price": "1000.00000000",
      "amount": "1000.00000000",
      "discount": "0.00000000"
    }
  ]
}

#Errores

#Descargar el XML crudo

Entrega el XML crudo del CFDI tal como fue almacenado (bronze). Esta respuesta no es JSON: es el archivo XML como adjunto.

• Content-Type: application/xml
• Content-Disposition: attachment; filename="{cfdi_uuid}.xml"

#Parámetros

curl "https://api.clarisfy.com/api/v1/cfdi/invoices/12345678-1234-1234-1234-123456789abc/xml?fiscalEntityId=fe_9a1c2b3d4e5f6071" \
  -H "Authorization: Bearer clf_live_secret_9K3mZ1pQ7rTx8vB4nH6dLwYe" \
  -o factura.xml

#Errores

#Pagos (REP) que liquidan un CFDI

Devuelve las asignaciones de pago (complementos tipo P / REP) que liquidan el CFDI PPD identificado por cfdi_uuid. Ordenadas por número de parcialidad y fecha de pago. Un CFDI sin pagos (o inexistente para la entidad) devuelve [].

#Parámetros

InvoicePaymentResponse (cada elemento del arreglo):

curl "https://api.clarisfy.com/api/v1/cfdi/invoices/12345678-1234-1234-1234-123456789abc/payments?fiscalEntityId=fe_9a1c2b3d4e5f6071" \
  -H "Authorization: Bearer clf_live_secret_9K3mZ1pQ7rTx8vB4nH6dLwYe"

[
  {
    "paying_cfdi_uuid": "abcdef12-3456-7890-abcd-ef1234567890",
    "payment_date": "2026-04-20T10:00:00+00:00",
    "partiality_number": 1,
    "amount": "1160.00",
    "paid_amount": "1000.00",
    "previous_balance": "1160.00",
    "pending_balance": "160.00",
    "currency": "MXN",
    "is_manual": false
  }
]

#Errores

#Vincular manualmente un pago (REP) a un CFDI PPD

Crea un vínculo manual entre un CFDI tipo P (REP) y un CFDI de ingreso PPD, para los casos en que el complemento de pago del SAT aún no reconcilia la factura (o nunca lo hará). El vínculo queda marcado is_manual = true (sobrevive a la re-ingesta del REP) y recalcula payment_status / outstanding_balance del PPD desde todas sus asignaciones, igual que un REP timbrado.

El saldo previo es el outstanding_balance actual del PPD (o su total si aún no tenía pagos); el saldo insoluto resultante es max(0, previo - amount).

#Parámetros

#Cuerpo de la petición

curl -X POST "https://api.clarisfy.com/api/v1/cfdi/invoices/12345678-1234-1234-1234-123456789abc/manual-payments?fiscalEntityId=fe_9a1c2b3d4e5f6071" \
  -H "Authorization: Bearer clf_live_secret_9K3mZ1pQ7rTx8vB4nH6dLwYe" \
  -H "Content-Type: application/json" \
  -d '{"payment_uuid": "abcdef12-3456-7890-abcd-ef1234567890", "amount": "1160.00"}'

Respuesta 201 Created (InvoicePaymentResponse, con is_manual: true):

{
  "paying_cfdi_uuid": "abcdef12-3456-7890-abcd-ef1234567890",
  "payment_date": "2026-04-20T10:00:00+00:00",
  "partiality_number": 1,
  "amount": "1160.00",
  "paid_amount": "1160.00",
  "previous_balance": "1160.00",
  "pending_balance": "0.00",
  "currency": "MXN",
  "is_manual": true
}

#Errores

#Eliminar un vínculo manual de pago

Elimina un vínculo de pago manual (is_manual = true) entre un REP (payment_uuid) y un CFDI PPD (invoice_uuid), y recalcula payment_status/outstanding_balance del PPD desde las asignaciones restantes. Nunca borra un pago proveniente de un complemento REP timbrado en el SAT.

#Parámetros

curl -X DELETE "https://api.clarisfy.com/api/v1/cfdi/invoices/12345678-1234-1234-1234-123456789abc/manual-payments/abcdef12-3456-7890-abcd-ef1234567890?fiscalEntityId=fe_9a1c2b3d4e5f6071" \
  -H "Authorization: Bearer clf_live_secret_9K3mZ1pQ7rTx8vB4nH6dLwYe"

Respuesta 204 No Content (sin cuerpo).

#Errores