Integration flow

The complete flow for API Web

Create/find place of issue → Issue CFDI → Download PDF/XML → Send by email →  (Cancel if applicable)

In practice, the client and product catalogs are managed separately and reused across multiple invoices. For the API, it is not necessary to have a client or product catalog for stamping, since that information is specified directly in the request JSON.

Step 1 — Manage places of issue

Before invoicing, you need to add your business’s place of issue / branch office; this procedure is done only once.

POST /BranchOffice

{
  "Name": "Sucursal principal ",
  "Description": "Sucursal de prueba para la emisión de facturas. ",
  "Address": {
    "Street": "Av Facturación",
    "ExteriorNumber": "123",
    "InteriorNumber": "",
    "Neighborhood": "Contadores",
    "ZipCode": "78000",
    "Locality": "Localidad",
    "Municipality": "San Luis Potosí",
    "State": "San Luis Potosí",
    "Country": "México"
  }
}

Save the ZipCode, since you will use it as the place of issue in the main request.

Step 2 — Issue the CFDI

POST /3/cfdis

{    
    "NameId": "1",
    "Folio": "100",
    "CfdiType": "I",
    "PaymentForm": "03",
    "PaymentMethod": "PUE",
    "ExpeditionPlace": "78000",
    "Date": "2026-06-14T12:00:00",
    "Receiver": {
        "Rfc": "XAXX010101000",
        "Name": "VENTA PÚBLICO EN GENERAL",
        "CfdiUse": "S01",
        "TaxZipCode": "78000",
        "FiscalRegime": "616"
    },
    "Items": [
        {
            "ProductCode": "01010101",
            "IdentificationNumber": "EDL",
            "Description": "Estudios de laboratorio",
            "Unit": "NO APLICA",
            "UnitCode": "MTS",
            "UnitPrice": 50,
            "Quantity": 2.0,
            "Subtotal": 100,
            "TaxObject": "02",
            "Taxes": [
                {
                    "Total": 16,
                    "Name": "IVA",
                    "Base": 100,
                    "Rate": 0.16,
                    "IsRetention": false
                }
            ],
            "Total": 116
        }       
    ]
}

Save the Id from the Response, since you will use it for the following operations.

Step 3 — Download PDF / XML

Once issued, download the PDF and XML:

GET /Cfdi/{format}/issued/{Id}  # format: pdf | xml | html

Step 4 — Send by email

You can send the PDF and XML by email:

POST /Cfdi?CfdiType=issued&CfdiId={Id}&Email=correo@ejemplo.com.mx

Step 5 — Cancellation (if applicable)

Cancellation with motive 02

DELETE /cfdi/{id}?type=issued&motive=02

Cancellation motives:

01 — Receipt issued with errors with a related document
02 — Receipt issued with errors without a related document
03 — The transaction did not take place
04 — Nominative transaction related in the global invoice

API Web vs Multi-issuer API

Feature	API Web	Multi-issuer API
Issuers	One (your account)	Multiple RFCs
CSD	Managed by Facturama	You must upload the CSD of each issuer
Ideal for	Your own companies	SaaS, marketplaces, accountants
Base endpoint	`/api/3/cfdis`	`/api-lite/3/cfdis` or `/api-lite/4/cfdis`

Checklist before going to production

Verify your production account

Create an account at app.facturama.mx, or sign in and verify that your account has an active subscription.

Purchase the API annual license

Purchase the API annual license from the shopping cart to enable access to the production API.

Upload your Digital Seal Certificate (CSD)

Upload your Digital Seal Certificate (.cer and .key) files. This is required to issue CFDIs in production.

Update the base URL

Change the base URL from https://apisandbox.facturama.mx to https://api.facturama.mx. No other code changes are required.

Issue a real CFDI

Create a real invoice for a small amount (for example, MXN $1.00) and verify that it appears in the SAT portal.

Recommended: Configure error handling

Implement retries with exponential backoff for temporary SAT 5xx errors.

Getting Started

Mexican Billing System

API Web

API Multiemisor

CFDI 4.0

Complements

SAT Catalogs

Tools

The complete flow for API Web

Step 1 — Manage places of issue

Step 2 — Issue the CFDI

Step 3 — Download PDF / XML

Step 4 — Send by email

Step 5 — Cancellation (if applicable)

API Web vs Multi-issuer API

Checklist before going to production

​The complete flow for API Web

​Step 1 — Manage places of issue

​Step 2 — Issue the CFDI

​Step 3 — Download PDF / XML

​Step 4 — Send by email

​Step 5 — Cancellation (if applicable)

​API Web vs Multi-issuer API

​Checklist before going to production

The complete flow for API Web

Step 1 — Manage places of issue

Step 2 — Issue the CFDI

Step 3 — Download PDF / XML

Step 4 — Send by email

Step 5 — Cancellation (if applicable)

API Web vs Multi-issuer API

Checklist before going to production