API para desarrolladores

Integra Enporte con tus sistemas para emitir CFDI 4.0 y su complemento Carta Porte 3.1 de forma programática: crear borradores, agregar conceptos, timbrar ante el SAT y descargar el XML y el PDF.

El acceso a la API está disponible en los planes Profesional y Empresarial. Genera tu API key desde el panel para empezar.

Autenticación

Todas las peticiones se autentican con una API key en la cabecera Authorization como token Bearer. La key queda acotada a la organización que la generó: la API nunca devuelve ni modifica datos de otra organización, así que no necesitas mandar el identificador de la tuya en ninguna petición.

curl https://enporte.com/api/v1/cfdi \
  -H "Authorization: Bearer tu_api_key"

Las respuestas son JSON. Las operaciones fiscales (timbrar, cancelar, registrar un pago) aceptan una llave de idempotencia para que un reintento por corte de red no emita dos veces el mismo comprobante ante el SAT.

Endpoints

36 operaciones sobre https://enporte.com/api/v1. Abajo está la referencia completa e interactiva, con esquemas de petición y respuesta.

CFDI

  • GET/cfdiListar CFDIs
  • POST/cfdiCrear borrador de CFDI
  • GET/cfdi/{id}Detalle de un CFDI
  • POST/cfdi/{id}/conceptsAgregar concepto (partida) al CFDI
  • POST/cfdi/{id}/stampTimbrar el CFDI ante el PAC
  • GET/cfdi/{id}/xmlDescargar XML timbrado
  • GET/cfdi/{id}/pdfDescargar PDF (representación impresa)
  • POST/cfdi/{id}/carta-porteAdjuntar complemento Carta Porte 3.1 a un CFDI borrador
  • POST/cfdi/{id}/cancelCancelar un CFDI timbrado
  • GET/cfdi/{id}/payment-historyHistorial de pagos (parcialidades) de un CFDI

Pagos (complemento REP)

  • POST/paymentsCrear CFDI de pago (REP, tipo P)
  • POST/payments/{id}/pagosAgregar un pago al CFDI de pago
  • GET/payments/pending-ppdFacturas con saldo pendiente (para REP)

Receptores

  • GET/receptoresListar receptores (clientes)
  • POST/receptoresCrear receptor
  • PATCH/receptores/{id}Actualizar receptor
  • DELETE/receptores/{id}Archivar receptor

Productos y servicios

  • GET/productosListar productos y servicios
  • POST/productosCrear producto o servicio
  • PATCH/productos/{id}Actualizar producto o servicio
  • DELETE/productos/{id}Archivar producto o servicio

Emisores (RFC)

  • GET/emisoresListar RFCs emisores (entidades fiscales)
  • GET/emisores/{id}Detalle de un RFC emisor (incluye CSDs y series)

Vehículos

  • GET/vehiculosListar vehículos
  • POST/vehiculosCrear vehículo
  • PATCH/vehiculos/{id}Actualizar vehículo (seguros / vigencia)

Operadores

  • GET/operadoresListar operadores (figuras de transporte)
  • POST/operadoresCrear operador
  • PATCH/operadores/{id}Actualizar operador

Remolques

  • GET/remolquesListar remolques
  • POST/remolquesCrear remolque

Ubicaciones

  • GET/ubicacionesListar ubicaciones
  • POST/ubicacionesCrear ubicación
  • PATCH/ubicaciones/{id}Actualizar ubicación

Reportes

  • GET/reports/incomeIngresos por periodo (mensual)
  • GET/reports/exportExportar CFDIs (Excel o Contpaq)