Documentación / API / Emisores (merchants)

Actualizar emisor

PATCHhttps://api.cfdi.express/v1/merchants/{id}API key

Actualiza razón social, régimen fiscal, código postal, serie o las claves SAT por default. El RFC no se puede cambiar.

Sólo se modifican los campos que mandes. Para cambiar de RFC, crea otro emisor: el CSD y los folios están atados al RFC.

Autenticación
Authorization: Bearer sk_test_... | sk_live_...

Parámetros

Parámetros de ruta

CampoTipoDescripción
idreqstringId del emisor.

Cuerpo (JSON)

CampoTipoDescripción
legalNamestringRazón social como la registra el SAT.
regimenFiscalstringClave de 3 dígitos de c_RegimenFiscal.
zipstringCódigo postal de expedición, 5 dígitos.
seriestringSerie de los folios, 1 a 10 caracteres.
defaultClaveProdServstringClave de producto/servicio de 8 dígitos.
defaultClaveUnidadstringClave de unidad por default.

Ejemplos

cURL
curl -X PATCH https://api.cfdi.express/v1/merchants/mkq2f8v3x1t7p9d4n6c0b5rz \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{ "serie": "F", "defaultClaveUnidad": "H87" }'

Respuesta

200 OK
{
  "id": "mkq2f8v3x1t7p9d4n6c0b5rz",
  "object": "merchant",
  "livemode": false,
  "rfc": "EKU9003173C9",
  "legalName": "ESCUELA KEMPER URGATE",
  "regimenFiscal": "601",
  "zip": "42501",
  "serie": "F",
  "defaultClaveProdServ": "01010101",
  "defaultClaveUnidad": "H87",
  "csd": { "object": "csd", "serialNumber": "30001000000500003416", "rfc": "EKU9003173C9", "validFrom": "2023-05-18T00:00:00.000Z", "validTo": "2027-05-18T00:00:00.000Z", "status": "active", "registeredWithPac": true, "updatedAt": "2026-08-18T16:24:51.002Z" },
  "logoUrl": null,
  "createdAt": "2026-08-18T16:20:03.114Z"
}

Errores

StatuscodeCuándo aparece
400validation_errorAlgún campo no pasó validación.
401unauthorizedFalta el header Authorization o la llave es inválida.
404not_foundEl emisor no existe en tu cuenta.

Continuar