Referencia API
/
Consultas al SAT
/
Consulta de Opinión de Cumplimiento (32D)

Moffin Solutions API (1.0.0)

API para la consulta de datos fiscales y financieros de contribuyentes.

Download OpenAPI description
index.json
index.yaml
Overview
Soporte Moffin Solutions

hola@moffin.mx

Languages
Servers
Mock server

https://solutions-docs.moffin.mx/_mock/apis/

Servidor de producción

https://solutions-api.moffin.mx/api/

Authentication

Operations

Consultas Empresariales

Operations

Consultas Fiscales

Operations

Consultas de Historial Laboral

Operations

Consultas al SAT

Operations

Creación de perfil SAT

Request

Para realizar consultas al SAT, primero es necesario crear el perfil de la persona a consultar proporcionando su RFC y CIEC.

Bodyapplication/jsonrequired
rfcstringrequired

RFC del contribuyente (12 a 13 caracteres)

Example: "MOCKRFC123456"
ciecstringrequired

Clave de Identificación Electrónica Confidencial (CIEC)

Example: "12345678"
curl -i -X POST \
  https://solutions-docs.moffin.mx/_mock/apis/query/sat/profile \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "rfc": "MOCKRFC123456",
    "ciec": "12345678"
  }'

Responses

Perfil SAT creado exitosamente

Bodyapplication/json
messagestring
Example: "Perfil creado satisfactoriamente"
rfcstring
Example: "MOCKRFC123456"
profileIdinteger
Example: 27287
Response
application/json
{
  "message": "Perfil creado satisfactoriamente",
  "rfc": "MOCKRFC123456",
  "profileId": 27287
}

Consulta de Situación Fiscal (CSF)

Request

Permite consultar la situación fiscal de un contribuyente mediante su RFC.

Nota: Antes de realizar esta consulta, es necesario crear un perfil SAT con el RFC y la CIEC.

Body de la solicitud:

{
    "rfc": "MOCKRFC123456"
}
Bodyapplication/jsonrequired
rfcstringrequired

RFC del contribuyente a consultar

Example: "MOCKRFC123456"
curl -i -X POST \
  https://solutions-docs.moffin.mx/_mock/apis/query/sat/csf \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "rfc": "MOCKRFC123456"
  }'

Responses

Consulta exitosa del CSF

Bodyapplication/json
_idstring
Example: "6791bc81d68f4ff2b76493d2"
servicestring
Example: "CSF"
statusstring
Example: "SUCCESS"
authenticationstring
Example: "MOFFIN"
metadataobject
queryobject
responseobject
organizationIdinteger
Example: 1
organizationSlugstring
Example: "moffin"
profileIdinteger
Example: 27287
createdAtstring
Example: "2025-01-23T03:50:25.858Z"
updatedAtstring
Example: "2025-01-23T03:52:11.224Z"
Response
application/json
{
  "_id": "6791bc81d68f4ff2b76493d2",
  "service": "CSF",
  "status": "SUCCESS",
  "authentication": "MOFFIN",
  "metadata": {
    "clientType": "PM",
    "query": { … }
  },
  "query": {
    "rfc": "MOCKRFC123456"
  },
  "response": {
    "claveMensaje": 0,
    "pdf": "https://deorp2zq6pc3v.cloudfront.net/csf/ac7b0db2-5fcc-4fcf-9075-8b1395643c90-MOCKRFC123456-CSF.pdf",
    "datosSat": { … },
    "codigoValidacion": "cs1737604226.9306736"
  },
  "organizationId": 1,
  "organizationSlug": "moffin",
  "profileId": 27287,
  "createdAt": "2025-01-23T03:50:25.858Z",
  "updatedAt": "2025-01-23T03:52:11.224Z"
}

Consulta de Opinión de Cumplimiento (32D)

Request

Permite obtener la Opinión de Cumplimiento (32D) de un contribuyente a partir de su RFC.

Nota: Antes de realizar esta consulta, es necesario crear un perfil SAT con el RFC y la CIEC.

Importante: La respuesta inicial confirmará el procesamiento de la consulta y los datos detallados se enviarán posteriormente mediante un webhook configurado.

Respuesta inicial:

{
    "message": "Solicitud de 32D procesada exitosamente",
    "queryId": "6791b7b4ddf6a1c971a08625"
}
Bodyapplication/jsonrequired
rfcstringrequired

RFC del contribuyente a consultar

Example: "MOCKRFC123456"
curl -i -X POST \
  https://solutions-docs.moffin.mx/_mock/apis/query/sat/compliance-opinion \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "rfc": "MOCKRFC123456"
  }'

Responses

Solicitud de Opinión de Cumplimiento procesada exitosamente

Bodyapplication/json
_idstring
Example: "6791c34927ad40b9491c3455"
servicestring
Example: "32D"
statusstring
Example: "SUCCESS"
authenticationstring
Example: "MOFFIN"
metadataobject
queryobject
responseobject
stateobject
organizationIdinteger
Example: 1
organizationSlugstring
Example: "moffin"
profileIdinteger
Example: 27287
createdAtstring
Example: "2025-01-23T04:19:21.953Z"
updatedAtstring
Example: "2025-01-23T04:19:47.691Z"
Response
application/json
{
  "_id": "6791c34927ad40b9491c3455",
  "service": "32D",
  "status": "SUCCESS",
  "authentication": "MOFFIN",
  "metadata": {
    "clientType": "PM",
    "query": { … }
  },
  "query": {
    "rfc": "MOCKRFC123456"
  },
  "response": {
    "opinion": "POSITIVA",
    "pdf": "https://deorp2zq6pc3v.cloudfront.net/32D/9b8a94bb-fc55-46db-afcf-f475d9020ae7-MOCKRFC123456-32D.pdf"
  },
  "state": {
    "validationCode": "gf1737605987.659957",
    "retry": 1
  },
  "organizationId": 1,
  "organizationSlug": "moffin",
  "profileId": 27287,
  "createdAt": "2025-01-23T04:19:21.953Z",
  "updatedAt": "2025-01-23T04:19:47.691Z"
}

Consulta de Facturas SAT

Request

Permite obtener las facturas de un contribuyente a partir de su RFC y un período de consulta.

Nota: Antes de realizar esta consulta, es necesario crear un perfil SAT con el RFC y la CIEC.

Importante: La respuesta inicial confirmará el procesamiento de la consulta y los datos detallados se enviarán posteriormente mediante un webhook configurado.

Respuesta inicial:

{
    "message": "Solicitud de facturas procesada exitosamente",
    "results": [
        {
            "queryId": "6791c6756a250515924f140f",
            "period": "2025-1",
            "status": "PENDING"
        },
        {
            "queryId": "6791c6796a250515924f1411",
            "period": "2024-12",
            "status": "PENDING"
        }
    ]
}
Bodyapplication/jsonrequired
rfcstringrequired

RFC del contribuyente a consultar

Example: "MOCKRFC123456"
periodstringrequired

Período de consulta de facturas

Enum"1M""3M""6M""1Y""2Y""3Y"
Example: "1Y"
curl -i -X POST \
  https://solutions-docs.moffin.mx/_mock/apis/query/sat/invoice \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "rfc": "MOCKRFC123456",
    "period": "1Y"
  }'

Responses

Solicitud de consulta de facturas procesada exitosamente

Bodyapplication/json
_idstring
Example: "1234567890abcdef12345678"
servicestring
Example: "invoices"
statusstring
Example: "SUCCESS"
authenticationstring
Example: "MOCK_AUTH"
metadataobject
queryobject
responseobject
stateobject
organizationIdinteger
Example: 99
organizationSlugstring
Example: "mock-organization"
profileIdinteger
Example: 55555
createdAtstring
Example: "2025-01-23T10:00:00.000Z"
updatedAtstring
Example: "2025-01-23T10:05:00.000Z"
Response
application/json
{
  "_id": "1234567890abcdef12345678",
  "service": "invoices",
  "status": "SUCCESS",
  "authentication": "MOCK_AUTH",
  "metadata": {
    "clientType": "PM",
    "query": { … }
  },
  "query": {
    "rfc": "ABC123456T89"
  },
  "response": {
    "periodo": "2025-01",
    "totalEmitidas": "$100,000.00",
    "totalRecibidas": "$50,000.00",
    "totalDiferencia": "$50,000.00",
    "facturasEmitidas": [ … ],
    "facturasRecibidas": [ … ],
    "codigoValidacion": "mock123456789",
    "message": null
  },
  "state": {
    "invoices": { … }
  },
  "organizationId": 99,
  "organizationSlug": "mock-organization",
  "profileId": 55555,
  "createdAt": "2025-01-23T10:00:00.000Z",
  "updatedAt": "2025-01-23T10:05:00.000Z"
}

Query Retrieval

Operations