Skip to main content

El flujo completo para API Web

En la práctica, los catálogos de clientes y productos se gestionan por separado y se reutilizan en múltiples facturas. Para la API no es necesario tener un catálogo de clientes o productos para el timbrado ya que esa información se especifica directamente en el JSON de la petición.

Paso 1 — Gestionar lugares de expedición

Antes de facturar necesitas agregar el lugar de expedición / sucursal de tu negocio, este procedimiento solo se hace una vez.
Guarda el ZipCode ya que lo vas a utilizar como lugar de expedición en la petición principal.

Paso 2 — Emitir el CFDI

Guarda el Id del Response ya que lo vas a utilizar para las siguientes operaciones.

Paso 3 — Descargar PDF / XML

Una vez emitido, descarga el PDF y XML :

Paso 4 — Enviar por correo electrónico

Puedes enviar el pdf y xml por correo electrónico:

Paso 5 — Cancelación (si aplica)

Cancelación con motivo 02
Motivos de cancelación:
  • 01 — Comprobante emitido con errores con relación
  • 02 — Comprobante emitido con errores sin relación
  • 03 — No se llevó a cabo la operación
  • 04 — Operación nominativa relacionada en la factura global

API Web vs API Multiemisor

Checklist antes de ir a producción

1

Verifica tus credenciales de producción

Crea tu cuenta en app.facturama.mx o Inicia sesión y verifica que tu cuenta tenga una suscripción activa.
2

Adquiere la anualidad de la API

Adquiere la anualidad de la API desde el carrito de compras para habilitar el acceso a la API de producción.
3

Carga tu CSD (Certificado de Sello Digital)

Sube tu Certificado de Sello Digital (.cer y .key). Es obligatorio para emitir CFDIs en producción desde la plataforma web o usando la API web.
4

Cambia la URL base

De https://apisandbox.facturama.mx a https://api.facturama.mx. El resto del código no cambia.
5

Prueba con un CFDI real de bajo monto

Emite una factura real de $1.00 y verifica que aparezca en el portal del SAT.
6

Recomendado: Configura el manejo de errores

Implementa reintentos con backoff exponencial para errores 5xx del SAT.