Datos de empleadores

Los datos de empleador (patrón) son información adicional de un emisor que se utilizan exclusivamente para emitir facturas de nómina. Los datos de empleador representan información patronal requerida únicamente en los CFDI de nómina. Existe una relación 1:1 entre un emisor y datos de empleador, por lo que para crear datos de empleador, primero se debe crear un emisor.

Tip: Los datos de empleador son un subrecurso del recurso de personas: /api/v4/people/<personId>/employer

Modelo datos de empleador

El modelo de datos de empleador contiene toda la información de los datos de empleador. Las propiedades con el sufijo Id corresponden a valores de los catálogos oficiales del SAT. Puede verlos en la página de Catálogos CFDI 4.0 o programáticamente a través de la API catalogs.

Propiedades

Name
id
Type
string?
Description
Id asignado por Fiscalapi.
Name
personId
Type
string
required
Description
Id de la persona a la que pertenecen los datos de empleador.
Name
employerRegistration
Type
string
required
Description
Registro patronal de la persona empleadora.
Name
originEmployerTin
Type
string?
Description
RFC del empleador original, utilizado cuando el patrón terceriza el pago de nómina.
Name
satFundSourceId
Type
string?
expandible
Description
Fuente de los fondos del patrón. Catálogo del SAT c_OrigenRecurso.
Solo cuando se trate de empresas que pertenecen al sistema nacional de coordinación fiscal (SNCF).
Type
enum:
Values
"IP""IF""IM"
Name
ownResourceAmount
Type
number?
conditional required
Description
Monto de los fondos propios del patrón. Sólo cuando se trate de empresas que pertenecen al sistema nacional de coordinación fiscal (SNCF). Requerido cuando se especifica satFundSourceId.

GET/api/v4/people/<personId>/employer

Obtener datos de empleador

Este endpoint te permite obtener los datos de empleador de una persona por id de persona.

Request

GET

/api/v4/people/<personId>/employer

curl --location 'https://test.fiscalapi.com/api/v4/people/<personId>/employer' \
--header 'X-TENANT-KEY: <tenant_key>' \
--header 'X-TIME-ZONE: America/Mexico_City' \
--header 'X-API-KEY: <api_key>'

Response

    {
    "data": {
        "personId": "bef56254-0892-4558-95c3-f9c8729e4b0e",
        "employerRegistration": "A1230768108",
        "originEmployerTin": "ARE180429TM6",
        "satFundSource": {
            "id": "IP",
            "description": "Ingresos propios.",
            "createdAt": "2024-08-10T15:46:30.373",
            "updatedAt": null
        },
        "ownResourceAmount": 1500,
        "id": "23f0b555-68bc-48fd-bb90-deb36ed25ef6",
        "createdAt": "2025-09-18T20:17:44.175",
        "updatedAt": "2025-09-18T20:17:48.489"
    },
    "succeeded": true,
    "message": "",
    "details": "",
    "httpStatusCode": 200
}

POST/api/v4/people/<personId>/employer

Crear datos de empleador

Este endpoint te permite crear datos de empleador a una persona por id de persona.

Modelo

Name
personId
Type
string
required
Description
Id de la persona a la que pertenecen los datos de empleador.
Name
employerRegistration
Type
string
required
Description
Registro patronal de la persona empleadora.
Name
originEmployerTin
Type
string?
Description
RFC del empleador original, utilizado cuando el patrón terceriza el pago de nómina.
Name
satFundSourceId
Type
string?
expandible
Description
Fuente de los fondos del patrón. Catálogo del SAT c_OrigenRecurso.
Solo cuando se trate de empresas que pertenecen al sistema nacional de coordinación fiscal (SNCF).
Type
enum:
Values
"IP""IF""IM"
Name
ownResourceAmount
Type
number?
conditional required
Description
Monto de los fondos propios del patrón. Solo cuando se trate de empresas que pertenecen al sistema nacional de coordinación fiscal (SNCF). Requerido cuando se especifica satFundSourceId.

Request

POST

/api/v4/people

curl --location 'https://test.fiscalapi.com/api/v4/people/bef56254-0892-4558-95c3-f9c8729e4b0e/employer' \
--header 'X-TENANT-KEY: <tenant-key>' \
--header 'X-TIME-ZONE: America/Mexico_City' \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: <api-key>' \
--data '{
  "personId": "bef56254-0892-4558-95c3-f9c8729e4b0e",
  "employerRegistration": "B5510768108",
  "originEmployerTin": "URE180429TM6",
  "satFundSourceId": null,
  "ownResourceAmount": null
}'

Response

{
    "data": {
        "personId": "bef56254-0892-4558-95c3-f9c8729e4b0e",
        "employerRegistration": "B5510768108",
        "originEmployerTin": "URE180429TM6",
        "satFundSource": null,
        "ownResourceAmount": null,
        "id": "23f0b555-68bc-48fd-bb90-deb36ed25ef6",
        "createdAt": "2025-09-18T20:17:44.175",
        "updatedAt": "2025-09-18T20:17:44.175"
    },
    "succeeded": true,
    "message": "",
    "details": "",
    "httpStatusCode": 200
}

PUT/api/v4/people/<personId>/employer

Actualizar datos de empleador

Este endpoint te permite actualizar los datos de empleador de una persona por id de persona.

Modelo

Name
personId
Type
string
required
Description
Id de la persona a la que pertenecen los datos de empleador.
Name
employerRegistration
Type
string
required
Description
Registro patronal de la persona empleadora.
Name
originEmployerTin
Type
string?
Description
RFC del empleador original, utilizado cuando el patrón terceriza el pago de nómina.
Name
satFundSourceId
Type
string?
expandible
Description
Fuente de los fondos del patrón. Catálogo del SAT c_OrigenRecurso.
Solo cuando se trate de empresas que pertenecen al sistema nacional de coordinación fiscal (SNCF).
Type
enum:
Values
"IP""IF""IM"
Name
ownResourceAmount
Type
number?
conditional required
Description
Monto de los fondos propios del patrón. Solo cuando se trate de empresas que pertenecen al sistema nacional de coordinación fiscal (SNCF). Requerido cuando se especifica satFundSourceId.

Request

PUT

/api/v4/people/<personId>/employer

curl --location --request PUT 'https://test.fiscalapi.com/api/v4/people/bef56254-0892-4558-95c3-f9c8729e4b0e/employer' \
--header 'X-TENANT-KEY: <tenant-key>' \
--header 'X-TIME-ZONE: America/Mexico_City' \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: <api-key>' \
--data '{
  "personId": "bef56254-0892-4558-95c3-f9c8729e4b0e",
  "employerRegistration": "A1230768108",
  "originEmployerTin": "ARE180429TM6",
  "satFundSourceId": null,
  "ownResourceAmount": null
}'

Response

    {
    "data": {
        "personId": "bef56254-0892-4558-95c3-f9c8729e4b0e",
        "employerRegistration": "A1230768108",
        "originEmployerTin": "ARE180429TM6",
        "satFundSource": null,
        "ownResourceAmount": null,
        "id": "23f0b555-68bc-48fd-bb90-deb36ed25ef6",
        "createdAt": "2025-09-18T20:17:44.175",
        "updatedAt": "2025-09-18T20:19:20.569"
    },
    "succeeded": true,
    "message": "",
    "details": "",
    "httpStatusCode": 200
}

DELETE/api/v4/people/<personId>/employer

Eliminar datos de empleador

Este endpoint te permite eliminar los datos de empleador de una persona por id de persona.

Request

DELETE

/api/v4/people/<personId>/employer

curl --location --request DELETE 'https://test.fiscalapi.com/api/v4/people/bef56254-0892-4558-95c3-f9c8729e4b0e/employer' \
--header 'X-TENANT-KEY: <tenant-key>' \
--header 'X-TIME-ZONE: America/Mexico_City' \
--header 'X-API-KEY: <api-key>' \
--data ''

Response

{
    "data": true,
    "succeeded": true,
    "message": "",
    "details": "",
    "httpStatusCode": 200
}