Meefi API

One REST API for Mexican fiscal and banking data. Sync SAT CFDI documents and fiscal certificates, query invoices with payment and credit aggregates, retrieve Banxico SPEI payment receipts, and receive webhooks when jobs complete.

Quickstart → · Architecture → · API reference →

sequenceDiagram
    autonumber
    participant App as Your application
    participant API as Meefi API
    participant SRC as SAT · Banxico

    App->>API: Register a taxpayer
    App->>API: Request documents or receipts
    API->>SRC: Retrieve on your behalf
    SRC-->>API: Documents + metadata
    API-->>App: Read via REST
    API-->>App: Webhooks (optional)

Get started

Getting started

Authenticate, register an entity, run an extraction, and read invoices.

Authentication

HTTP Basic auth and organization scoping.

Architecture

How the service works: resources, data flow, and aggregates.

Platform

Entities

RFC + CIEC registration, credential validation, and lifecycle.

Extractions

Async background jobs: trigger, poll status, and retrieve results.

Webhooks

Event payloads, signing, and handler patterns.

Credentials

CIEC (SAT portal password, for extractions) and CSD (digital seal certificate, for issuing). Upload, activate, and rotate both credential kinds.

SAT

CSF

Constancia de Situación Fiscal: extraction, parsed fields, and PDF download.

CSF validation (RFC + idCIF)

The taxpayer record behind a constancia, by RFC and idCIF: name, status, address, and regimes.

Compliance opinion (32-D)

Opinión de Cumplimiento: extraction, parsed result, and PDF download.

Certificates (e.firma / CSD)

A taxpayer's FIEL/CSD certificates by RFC: serial, status, type, and file.

Invoices: overview

What the API does, supported CFDI types, prerequisites, and a quickstart (upload CSD → issue → download).

Issue an invoice (I / E / T)

POST /v1/issued-invoices for Ingreso, Egreso, and Traslado: base fields, items, taxes, discounts, credit notes, global invoices, and foreign receivers.

Payment receipts (REP / type P)

Issue a CFDI type P (Complemento de Pago 2.0) to acknowledge receipt of payments against PPD invoices.

Payroll (Nómina / type N)

Issue a CFDI type N (Complemento de Nómina 1.2): employee, payroll period, perceptions, deductions, and other payments.

Carta Porte 3.1

Attach the Complemento Carta Porte 3.1 to a type I or T invoice: locations, goods, transport, and operator.

List & retrieve

GET /v1/invoices unified list, per-entity lists, XML/PDF download, and extraction filters with PPD aggregates.

Cancel an invoice

DELETE /v1/issued-invoices/{id}: cancellation reasons, async SAT workflow, and polling for the final status.

Reference: catalogs & statuses

All catalog tables (type, payment method, tax object, tax type/factor, cancellation reasons, SAT catalog pointers), status lifecycles, and the consolidated error table.