Capítulo 4 - "Obtención de Información de Ubicación Fiscal por RFC"

Objetivo del Tutorial

Aprende a consultar los datos de ubicación fiscal de una empresa o persona física utilizando su RFC a través de la API de Moffin Solutions.

Requisitos previos

Antes de comenzar, asegúrate de contar con los siguientes elementos:

Un RFC válido del contribuyente.
Credenciales de acceso a la API de Moffin (clientId y clientSecret).

Paso 1: Obtener el token de autenticación

Para poder realizar consultas, primero necesitamos autenticarnos en la API de Moffin y obtener un token de acceso.

Llamada a la API:

curl -i -X POST \
  https://solutions-api.moffin.mx/api/oauth/token \
  -H 'Content-Type: application/json' \
  -d '{
    "grantType": "client_credentials",
    "clientId": "MOFFIN_cccccccc-aaaa-5555-aa33-11111111111",
    "clientSecret": "eeeee111-aa221-2313-1111-a15aa15c15aa"
  }'

Response

application/json

{
  "accessToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "refreshToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "tokenType": "Bearer",
  "accessTokenExpiresAt": 1737686951,
  "refreshTokenExpiresAt": 1738205351
}

Paso 2: Consultar la información de ubicación fiscal

Con el token de autenticación obtenido, podemos realizar la consulta para obtener los datos de ubicación fiscal del contribuyente.

Llamada a la API:

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

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"
}

Paso 3: Procesar la respuesta de la API

Con la información recibida en la respuesta, puedes almacenarla o utilizarla para análisis fiscales o administrativos.

Estructura de los datos obtenidos:

RFC: MOCKRFC123456
Municipio: Zapopan
Estado: Jalisco
Ciudad: Zapopan
Oficina Postal: 45040
Zona: Urbano

Conclusión

Siguiendo estos pasos, has aprendido a automatizar la obtención de datos de ubicación fiscal de un contribuyente utilizando su RFC con la API de Moffin Solutions.