Referencia · API v1

API 69-B para desarrolladores

Verifica el estatus de un RFC en el listado del Artículo 69-B del SAT y automatiza el monitoreo de proveedores desde tu ERP o sistema contable.

Actualizado · Versión v1 · julio de 2026

Obtener clave API Ver planes y límites

§ 1

Autenticación

Todas las peticiones usan HTTPS y se autentican con una clave secreta de tu organización en el encabezado Authorization. Genera y revoca claves desde tu cuenta. La clave se muestra una sola vez; guárdala de forma segura y no la expongas en el cliente.

Base URL

https://69b.com.mx/api/v1

Encabezado

Authorization: Bearer sk_live_...

§ 2

Endpoints

GET/api/v1/verify?rfc=CIN180314K21

Verifica un RFC contra el listado 69-B. Consume 1 verificación de la cuota.

Respuesta

{
  "rfc": "CIN180314K21",
  "found": true,
  "situacion": "definitivo",
  "razon_social": "Comercializadora Industrial del Norte",
  "verificado_en": "2026-07-10T18:24:00.000Z",
  "ultima_sincronizacion": "2026-07-10",
  "oficios": {
    "presuncion": "500-05-2024-0012",
    "definitivo": "500-05-2025-0431",
    "publicacion_dof": "2026-05-12"
  }
}

POST/api/v1/verify/batch

Verifica hasta 500 RFCs en una sola llamada. Consume una verificación por RFC válido.

Cuerpo

{ "rfcs": ["CIN180314K21", "SLP1607029A3"] }

Respuesta

{
  "total": 2,
  "verificados": 2,
  "resultados": [
    { "rfc": "CIN180314K21", "valido": true, "found": true,
      "situacion": "definitivo", "razon_social": "..." },
    { "rfc": "SLP1607029A3", "valido": true, "found": true,
      "situacion": "definitivo", "razon_social": "..." }
  ]
}

GET/api/v1/watchlist

Lista los RFCs bajo monitoreo con su estatus actual. No consume cuota.

Respuesta

{
  "total": 1,
  "items": [
    { "id": "wl_...", "rfc": "GTM191128M45", "etiqueta": "Proveedor textil",
      "situacion": "presunto", "razon_social": "Grupo Textil Metropolitano" }
  ]
}

POST/api/v1/watchlist

Agrega un RFC al monitoreo automatizado. Recibirás alerta cuando cambie de estatus.

Cuerpo

{ "rfc": "GTM191128M45", "etiqueta": "Proveedor textil" }

Respuesta

{ "ok": true }

§ 3

Límites y costos

El acceso a la API se incluye desde el plan Smart. La cuota se reinicia cada mes; las verificaciones por encima de lo incluido se facturan al costo adicional de tu plan.

	Smart	Corporativo	Empresarial
Verificaciones / mes	1,000	15,000	150,000
Verificación adicional	$0.40 c/u	$0.20 c/u	$0.10 c/u
Rate limit	5/s	20/s	100/s
Claves activas	1	3	10
Webhooks de estatus	—	Sí	Sí
Precio del plan	$199/mes	$1,999/mes	$6,999/mes

§ 4

Webhooks

Registra un endpoint desde tu cuenta (planes Corporativo y Empresarial) y recibirás un POST cuando un RFC de tu watchlist cambie de estatus. Verifica cada evento comparando el header X-69b-Signature con el HMAC-SHA256 del cuerpo usando el secreto del endpoint.

Cuerpo del evento

{
  "type": "watchlist.status_changed",
  "created": "2026-07-10T18:24:00.000Z",
  "data": {
    "changes": [
      { "rfc": "CIN180314K21", "from": "presunto", "to": "definitivo" }
    ]
  }
}

Verificación de firma (Node)

import { createHmac } from "node:crypto";

const sig = req.headers["x-69b-signature"];        // "sha256=..."
const expected = "sha256=" + createHmac("sha256", SECRET)
  .update(rawBody)
  .digest("hex");
if (sig !== expected) return res.status(400).end(); // firma inválida

§ 5

Errores

Los errores usan el código HTTP correspondiente y un cuerpo { "error": { "code", "message" } }.

401missing_key / invalid_keyFalta la clave o es inválida/revocada.

403plan_requiredTu plan no incluye API. Mejora a Smart o superior.

422invalid_rfc / invalid_bodyEl RFC o el cuerpo de la petición no son válidos.

429rate_limitedExcediste el límite de peticiones por segundo de tu plan.

429quota_exceededAgotaste las verificaciones incluidas del mes y tu organización no tiene una suscripción activa para cobrar el excedente. Con suscripción activa, las verificaciones adicionales se cobran por uso con la tarifa de tu plan.

Empieza a integrar

Genera tu clave, prueba con un RFC y conéctalo a tu flujo de alta de proveedores. ¿Necesitas volúmenes mayores a 150,000 verificaciones al mes? Escríbenos.

Obtener clave API