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

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

Calcula el RFC de una Persona Física

Request

Este endpoint permite calcular el RFC (Registro Federal de Contribuyentes) de una persona física proporcionando su nombre, apellidos y fecha de nacimiento.

Bodyapplication/jsonrequired

namestringrequired

Nombres de la persona.

Example: "ALAN ISAAC"

firstLastNamestringrequired

Primer apellido de la persona.

Example: "CARDOZO"

secondLastNamestring

Segundo apellido de la persona (opcional).

Example: "AGUILAR"

dayintegerrequired

Día de nacimiento.

Example: 15

monthintegerrequired

Mes de nacimiento.

Example: 1

yearintegerrequired

Año de nacimiento.

Example: 1998

curl -i -X POST \
  https://solutions-docs.moffin.mx/_mock/apis/query/rfc-calculator \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "ALAN ISAAC",
    "firstLastName": "CARDOZO",
    "secondLastName": "AGUILAR",
    "day": 15,
    "month": 1,
    "year": 1998
  }'

Responses

RFC calculado exitosamente.

Bodyapplication/json

_idstring

ID único de la consulta.

Example: "6799511306b78436bf222363"

servicestring

Servicio utilizado.

Example: "RFC_CALCULATOR"

statusstring

Estado de la consulta.

Example: "SUCCESS"

authenticationstring

Mecanismo de autenticación utilizado.

Example: "MOFFIN"

metadataobject

queryobject

responseobject

stateobject

Estado de la consulta.

organizationIdinteger

Example: 1

organizationSlugstring

Example: "moffin"

profileIdstring

Example: 99999

createdAtstring(date-time)

Example: "2025-01-28T21:50:09.350Z"

updatedAtstring(date-time)

Example: "2025-01-28T21:50:11.493Z"

Response

application/json

{
  "_id": "6799511306b78436bf222363",
  "service": "RFC_CALCULATOR",
  "status": "SUCCESS",
  "authentication": "MOFFIN",
  "metadata": {
    "clientType": "PF",
    "query": { … }
  },
  "query": {
    "name": "ALAN ISAAC",
    "firstLastName": "CARDOZO",
    "secondLastName": "AGUILAR",
    "year": 1998,
    "month": 1,
    "day": 15
  },
  "response": {
    "rfc": "CAAA980115QN3"
  },
  "state": {},
  "organizationId": 1,
  "organizationSlug": "moffin",
  "profileId": 99999,
  "createdAt": "2025-01-28T21:50:09.350Z",
  "updatedAt": "2025-01-28T21:50:11.493Z"
}

Consulta de Constancia de Régimen Fiscal (CRF)

Request

Permite obtener la Constancia de Régimen Fiscal (CRF) de un contribuyente a partir de su RFC. La respuesta inicial confirmará el procesamiento de la consulta, y los datos detallados se enviarán posteriormente mediante un webhook configurado.

Respuesta inicial:

{
    "message": "Consulta de Certificado de régimen fiscal procesada exitosamente.",
    "queryId": "6791b216ddf6a1c971a08624"
}

Bodyapplication/jsonrequired

rfcstringrequired

RFC del contribuyente a consultar

Example: "MOCKRFC123456"

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

Responses

Consulta exitosa del CRF

Bodyapplication/json

_idstring

Identificador único de la consulta

Example: "abcdef1234567890"

servicestring

Example: "CRF"

statusstring

Example: "SUCCESS"

authenticationstring

Example: "MOFFIN"

metadataobject

queryobject

responseobject

stateobject

organizationIdinteger

Example: 1

organizationSlugstring

Example: "moffin"

profileIdinteger

Example: 1217955

createdAtstring(date-time)

Example: "2025-01-23T03:05:58.729Z"

updatedAtstring(date-time)

Example: "2025-01-23T03:06:00.543Z"

Response

application/json

{
  "_id": "abcdef1234567890",
  "service": "CRF",
  "status": "SUCCESS",
  "authentication": "MOFFIN",
  "metadata": {
    "clientType": "PF",
    "query": { … }
  },
  "query": {
    "rfc": "MOCKRFC123456"
  },
  "response": {
    "RFC": "MOCKRFC123456",
    "RazonSocial": "EMPRESA MOCK S.A. DE C.V.",
    "ValidoDesde": "2021-06-08T12:35:54",
    "ValidoHasta": "2025-06-08T12:36:34",
    "RFCRepresentante": "string",
    "CURPRepresentante": "MOCKCURP123456",
    "EmailContacto": "contacto@example.com",
    "EstadoCertificado": "Vigente",
    "NumeroCertificado": "00001000000507699213",
    "Valido": true,
    "Municipio": "Cuauhtémoc",
    "Estado": "Ciudad de México",
    "Ciudad": "Ciudad de México",
    "OficinaPostal": "06002",
    "Zona": "Urbano",
    "EstadoISO": "CMX",
    "CodigoPostal": "00000",
    "RegimenesFiscales": [ … ]
  },
  "state": {
    "FISCAL_DATA": { … }
  },
  "organizationId": 1,
  "organizationSlug": "moffin",
  "profileId": 1217955,
  "createdAt": "2025-01-23T03:05:58.729Z",
  "updatedAt": "2025-01-23T03:06:00.543Z"
}

Consulta de Datos del RFC

Request

Permite obtener la información detallada del RFC de un contribuyente. La respuesta inicial confirmará el procesamiento de la consulta, y los datos detallados se enviarán posteriormente mediante un webhook configurado.

Respuesta inicial:

{
    "message": "Consulta de RFC 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/rfc-data \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "rfc": "MOCKRFC123456"
  }'

Responses

Consulta exitosa de RFC

Bodyapplication/json

_idstring

Example: "6791b7b4ddf6a1c971a08625"

servicestring

Example: "RFC"

statusstring

Example: "SUCCESS"

authenticationstring

Example: "MOFFIN"

metadataobject

queryobject

responseobject

stateobject

organizationIdinteger

Example: 1

organizationSlugstring

Example: "moffin"

profileIdinteger

Example: 1183443

createdAtstring(date-time)

Example: "2025-01-23T03:29:56.947Z"

updatedAtstring(date-time)

Example: "2025-01-23T03:29:57.965Z"

Response

application/json

{
  "_id": "6791b7b4ddf6a1c971a08625",
  "service": "RFC",
  "status": "SUCCESS",
  "authentication": "MOFFIN",
  "metadata": {
    "clientType": "PM",
    "query": { … }
  },
  "query": {
    "rfc": "CCC222222C19"
  },
  "response": {
    "RFC": "CCC222222C19",
    "RazonSocial": "INTERNACIONAL SA DE CV",
    "ValidoDesde": "2023-10-20T13:37:35",
    "ValidoHasta": "2027-10-20T13:38:15",
    "RFCRepresentante": "ALCJ8888888B8",
    "CURPRepresentante": "AICL888888HOCLSN06",
    "EmailContacto": "diian@acme.com",
    "EstadoCertificado": "Vigente",
    "NumeroCertificado": "00001000000703019308",
    "Valido": true,
    "Municipio": "Cuauhtémoc",
    "Estado": "Ciudad de México",
    "Ciudad": "Ciudad de México",
    "OficinaPostal": "06002",
    "Zona": "Urbano",
    "EstadoISO": "CMX",
    "CodigoPostal": "06000"
  },
  "state": {
    "FISCAL_DATA": { … }
  },
  "organizationId": 1,
  "organizationSlug": "moffin",
  "profileId": 1183443,
  "createdAt": "2025-01-23T03:29:56.947Z",
  "updatedAt": "2025-01-23T03:29:57.965Z"
}

Consulta de datos de CURP

Request

Permite obtener información de un CURP, incluyendo datos personales y el RFC asociado.

Bodyapplication/jsonrequired

curpstringrequired

CURP del individuo a consultar

Example: "MOCKCURP123456XX9"

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

Responses

Consulta exitosa de CURP

Bodyapplication/json

_idstring

Example: "mock123456789"

servicestring

Example: "CURP"

statusstring

Example: "SUCCESS"

authenticationstring

Example: "MOCK_AUTH"

metadataobject

queryobject

responseobject

organizationIdinteger

Example: 99

organizationSlugstring

Example: "mock-organization"

profileIdinteger

Example: 12345

createdAtstring(date-time)

Example: "2025-01-23T19:26:07.076Z"

updatedAtstring(date-time)

Example: "2025-01-23T19:26:07.259Z"

Response

application/json

{
  "_id": "mock123456789",
  "service": "CURP",
  "status": "SUCCESS",
  "authentication": "MOCK_AUTH",
  "metadata": {
    "clientType": "PF",
    "query": { … }
  },
  "query": {
    "curp": "MOCKCURP123456XX9"
  },
  "response": {
    "rfc": "MOCKRFC123456",
    "estatus": "OK",
    "codigoValidacion": "mock-validation-code",
    "curp": "MOCKCURP123456XX9",
    "nombre": "JOHN",
    "apellidoPaterno": "DOE",
    "apellidoMaterno": "SMITH",
    "sexo": "HOMBRE",
    "fechaNacimiento": "09/07/1961",
    "paisNacimiento": "MEXICO",
    "estadoNacimiento": "CIUDAD DE MEXICO",
    "docProbatorio": 1,
    "datosDocProbatorio": { … },
    "estatusCurp": "AN",
    "codigoMensaje": "0"
  },
  "organizationId": 99,
  "organizationSlug": "mock-organization",
  "profileId": 12345,
  "createdAt": "2025-01-23T19:26:07.076Z",
  "updatedAt": "2025-01-23T19:26:07.259Z"
}

Consultas de Historial Laboral

Operations

Consultas al SAT

Operations

Query Retrieval

Operations

Moffin Solutions API (1.0.0)

Authentication

Consultas Empresariales

Consultas Fiscales

Calcula el RFC de una Persona Física

Request

Responses

Was this helpful?

Consulta de Constancia de Régimen Fiscal (CRF)

Request

Responses

Was this helpful?

Consulta de Datos del RFC

Request

Responses

Was this helpful?

Consulta de datos de CURP

Request

Responses

Was this helpful?

Consultas de Historial Laboral

Consultas al SAT

Query Retrieval