CFDI Validation Payroll

Description

A CFDI is Mexico’s official electronic invoice format, regulated by the Servicio de Administración Tributaria (SAT). It is a digital tax receipt in XML format, validated and “timbrado” (stamped) by an authorized PAC (Proveedor Autorizado de Certificación). Each CFDI contains:

• Information about the issuer and recipient (RFC, name, regime, use of CFDI).
• Transaction details (products/services, amounts, taxes, payment methods).
• Unique identifiers (UUID, digital seals, QR code).
• SAT validation (legal proof that the invoice is authentic and registered). It fully replaces paper invoices and is mandatory for virtually all economic activities in Mexico including payment of payrolls.

HTTP method GET

Endpoint

https://api.msla-id.com/experience-idv-taxes-api-v1/api/idv-govcheck/v1/mx-tax-identifications/cfdi-validation-payroll?issuers_rfc=<value>&reseivers_rfc=<value>&cfdi_folio=<value>

[SANDBOX Environment]

For testing purposes, use the base domain: apidev.msla-id.com

info

Before proceeding, make sure you have your jwt token, if you don't, check the login documentation.

Request header parameter

NAME	REQUIRED	TYPE	DESCRIPTION
Authorization	✅	string	bearer jwt token

Query request parameter

NAME	REQUIRED	TYPE	DESCRIPTION	EXAMPLE
issuers_rfc	✅	string	Tax Id number of issuer	CMC0712144R4
reseivers_rfc	✅	string	Tax Id number of receiver	MSV9110143D4
cfdi_folio	✅	string	Invoice Number / Unique ID	00000000-0000-0000-0000-000000000000

Status code responses

Code	Description
200	OK
400	Bad request
401	Unauthorized
404	Not found
500	Internal server error.

The full documentation error codes can be found here.

Response 200 status code

{
    "traceId": "62fa8427713c544f",
    "timestamp": "2026-03-09 14:36:54",
    "data": {
        "payroll": {
            "validationCode": "fd1773085013.2798939",
            "voucherEffect": "Nómina",
            "cfdiStatus": "Vigente",
            "status": "OK",
            "cancellationStatus": "Cancelable sin aceptación",
            "certificationDate": "2022-12-15T14:59:05",
            "issueDate": "2022-12-15T12:58:01",
            "fiscalFolioUuid": "F503E252-F5BE-40C2-903D-202E3FB072AF",
            "issuerName": "PLAMEX",
            "receiverName": "CALLEJA LEAL,JHOVANY",
            "issuerRfc": "PLA720201746",
            "pacRfc": "PPD101129EA3",
            "receiverRfc": "CALJ960126DR7",
            "cfdiTotal": 2322.2,
            "currency": "MXN"
        }
    }
}

Response 400 status code

{
    "traceId": "542fc743fffda052",
    "timestamp": "2023-05-05 11:20:46",
    "code": "IDV-4005",
    "message": "-",
    "data": null
}

Response 401 status code

{
    "timestamp": "YYYY-MM-DDTHH:mm:ss.sssZ",
    "status": 401,
    "error": "Unauthorized",
    "path": "/api/idv-govcheck/v1/mx-tax-identifications/cfdi-validation-payroll?issuers_rfc=<value>&reseivers_rfc=<value>&cfdi_folio=<value>"
}

Response 500 status code

{
    "traceId": "43a20f33d4e8730d",
    "timestamp": "yyyy-mm-dd HH:MM:SS",
    "code": "IDV-1001",
    "message": "A generic error has occurred.",
    "data": null
}