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_...

El header x-account-id indica la cuenta. Si no eres miembro, la respuesta es 403.

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