Catálogos del SAT

El Servicio de Administración Tributaria (SAT) proporciona un conjunto de catálogos estandar para la facturación electrónica en México. Estos catálogos contienen codigos y descripciones que se utilizan en la emisión de facturas CFDI.

Los catálogos de Fiscalapi contienen los mismos registros que los catálogos del SAT, vea catálogos sat si no deseas hacer una llamada a la API para obtener los registros.

Equivalencia entre catálogos del SAT y Fiscalapi

Fiscalapi proporciona cátalogos equivalentes con exactamente los mismos registros del SAT. A continuación se muestra una tabla con los nombres de los catálogos del SAT y su equivalencia en Fiscalapi.

Catálogo SAT	Catálogo API	Descripción
c_FormaPago	SatPaymentForms	Catálogo de métodos de pago aceptados en la factura
c_Moneda	SatCurrencies	Catálogo de monedas permitidas en la factura
c_TipoDeComprobante	SatInvoiceTypes	Catálogo de tipos de factura permitidas en la factura
c_Exportacion	SatExportCodes	Catálogo de operaciones de exportación en la factura
c_MetodoPago	SatPaymentMethods	Catálogo de métodos de pago en la factura
c_Periodicidad	SatPeriodicities	Catálogo de periodicidad de la factura global
c_Meses	SatMonths	Catálogo de periodos aplicables a la factura
c_TipoRelacion	SatRelationshipTypes	Catálogo de tipos de relación entre facturas
c_RegimenFiscal	SatTaxRegimes	Catálogo de regímenes fiscales del emisor/receptor de la factura
c_UsoCFDI	SatCfdiUses	Catálogo de usos del cfdi de la factura
c_ClaveProdServ	SatProductCodes	Catálogo de claves de productos y servicios de la factura
c_ClaveUnidad	SatUnitMeasurements	Catálogo de unidades de medida para los productos de la factura
c_ObjetoImp	SatTaxObjects	Catálogo de objetos de impuesto para los productos de la factrua
c_Impuesto	SatTaxes	Catálogo de impuestos aplicables en la factura
c_TipoFactor	SatTaxTypes	Catálogo de tipos de factor en impuestos de los productos de la factura
c_MotivosCancelacion	SatCancellationReasons	Catálogo de motivos de cancelación de facturas

Modelo PagedList

El modelo PagedList organiza las respuestas en respuestas páginadas para facilitar la navegación, incluyendo una lista de elementos por página, el número de página actual, total de páginas disponibles, cantidad total de elementos e indicadores de navegación (página anterior/siguiente). Puedes filtrar estos resultados usando términos de búsqueda en tus solicitudes. Para más detalles sobre los modelos de respuesta de fiscalapi.

Propiedades

Name
items
Type
array of objects (T)?
Description
Lista de elementos en la página actual.
Name
pageNumber
Type
integer?
Description
Número de la página actual.
Name
totalPages
Type
integer?
Description
Número total de páginas.
Name
totalCount
Type
integer?
Description
Número total de elementos.
Name
hasPreviousPage
Type
boolean?
Description
Indica si hay una página anterior.
Name
hasNextPage
Type
boolean?
Description
Indica si hay una página siguiente.

GET/api/v4/catalogs

Listar catálogos

Este endpoint devuelve un arreglo de cadenas (string[]) con los nombres de los catálogos disponibles. Estos nombres se utilizan para obtener los registros de un catálogo en particular, aplicando los filtros de búsqueda correspondientes.

Tip: También puedes obtener la lista de catálogos disponibles y sus registros en la página catalogs-, excepto los catálogos SatUnitMeasurements y SatProductCodes, debido a que contienen una gran cantidad de registros.

Request

GET

/api/v4/catalogs

curl --location 'https://test.fiscalapi.com/api/v4/catalogs' \
--header 'X-TENANT-KEY: <tenant>' \
--header 'X-TIME-ZONE: America/Mexico_City' \
--header 'X-API-KEY: <apikey>' \
--data ''

Response

{
    "data": [
        "SatCfdiUses",
        "SatCountries",
        "SatCurrencies",
        "SatExportCodes",
        "SatInvoiceTypes",
        "SatMonths",
        "SatTaxObjects",
        "SatPaymentForms",
        "SatPaymentMethods",
        "SatPeriodicities",
        "SatProductCodes",
        "SatRelationshipTypes",
        "SatTaxes",
        "SatStates",
        "SatTaxRegimes",
        "SatTaxTypes",
        "SatUnitMeasurements",
        "ProductTypes",
        "ProductDivisions",
        "ProductGroups",
        "ProductClasses",
        "UserTypes",
        "ReportRuleTypes",
        "Taxes",
        "TaxFlags",
        "TaxTypes",
        "TaxRules",
        "PersonTypes",
        "InvoiceStatuses"
    ],
    "succeeded": true,
    "message": "",
    "details": "",
    "httpStatusCode": 200
}

GET/api/v4/catalogs

Obtener registro por ID

Este endpoint permite obtener un registro de un catálogo pasando como parámetro el nombre del catálogo y el ID del registro. En este ejemplo se obtiene el registro con el ID 84111500 del catálogo SatProductCodes.

Request

GET

/v4/catalogs/SatProductCodes/key/84111500

curl --location 'https://test.fiscalapi.com/api/v4/catalogs/SatProductCodes/key/84111500' \
--header 'X-TENANT-KEY: <tenant>' \
--header 'X-TIME-ZONE: America/Mexico_City' \
--header 'X-API-KEY: <apikey>' \
--data ''

Response

{
    "data": {
        "id": "84111500",
        "description": "Servicios contables",
        "createdAt": "2025-01-07T08:24:19.7833333",
        "updatedAt": null
    },
    "succeeded": true,
    "message": "",
    "details": "",
    "httpStatusCode": 200
}

GET/api/v4/catalogs

Buscar en un catálogo

Este endpoint permite buscar registros en un catálogo pasando como parámetro el nombre del catálogo y un término de búsqueda. En este ejemplo se buscan los registros del catálogo SatProductCodes que contienen la palabra contables.

Query parameters

Name
pageNumber
Type
int
required
Description
El número de página que se desea recuperar.
Default:
1
Name
pageSize
Type
int
required
Description
Valor entre 1 y 100 inclusivo para indicar la cantidad de registros devueltos por página.
Default:
50

Request

GET

/v4/catalogs/SatProductCodes/key/84111500

curl --location 'https://test.fiscalapi.com/api/v4/catalogs/SatProductCodes/contables?pageNumber=1&pageSize=100' \
--header 'X-TENANT-KEY: <tenant>' \
--header 'X-TIME-ZONE: America/Mexico_City' \
--header 'X-API-KEY: <apikey>' \
--data ''

Response

{
    "data": {
        "items": [
            {
                "id": "14111808",
                "description": "Formatos contables o libros de contabilidad",
                "createdAt": "0001-01-01T00:00:00.0000000",
                "updatedAt": null
            },
            {
                "id": "84111500",
                "description": "Servicios contables",
                "createdAt": "0001-01-01T00:00:00.0000000",
                "updatedAt": null
            }
        ],
        "pageNumber": 1,
        "totalPages": 1,
        "totalCount": 2,
        "hasPreviousPage": false,
        "hasNextPage": false
    },
    "succeeded": true,
    "message": "",
    "details": "",
    "httpStatusCode": 200
}