# Crear emisor

> `POST https://api.cfdi.express/v1/merchants` — Registra un RFC emisor con su régimen fiscal, código postal de expedición y serie. Es el primer paso antes de timbrar.

URL de esta página: https://cfdi.express/docs/api/crear-emisor
Autenticación: requiere API key (`Authorization: Bearer sk_test_…` o `sk_live_…`)

La **razón social** debe ir exactamente como aparece en tu Constancia de Situación Fiscal, en mayúsculas y sin el sufijo de régimen societario (`SA DE CV`, `S DE RL`…) salvo que esté impreso ahí. El SAT rechaza el timbrado si no coincide.

Una cuenta puede tener varios emisores activos a la vez; eliges cuál factura con `merchantId` en cada request.

Después de crearlo, sube su CSD con [POST /v1/merchants/{id}/csd](https://cfdi.express/docs/api/subir-csd). Sin CSD el emisor no puede timbrar.

### Cuerpo (JSON)

| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| `rfc` | string | sí | RFC del emisor, 12 o 13 caracteres en mayúsculas. |
| `legalName` | string | sí | Razón social tal como está registrada ante el SAT. Máximo 300 caracteres. |
| `regimenFiscal` | string | sí | Clave de 3 dígitos del catálogo c_RegimenFiscal (601, 626, 612…). |
| `zip` | string | sí | Código postal del lugar de expedición, 5 dígitos. |
| `serie` | string | no | Serie de los folios. 1 a 10 caracteres. Default A. |
| `defaultClaveProdServ` | string | no | Clave de producto/servicio de 8 dígitos usada cuando un concepto no trae la suya. |
| `defaultClaveUnidad` | string | no | Clave de unidad usada por default (por ejemplo E48 o H87). |

## Ejemplos

### cURL

```bash
curl -X POST https://api.cfdi.express/v1/merchants \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{
    "rfc": "EKU9003173C9",
    "legalName": "ESCUELA KEMPER URGATE",
    "regimenFiscal": "601",
    "zip": "42501",
    "serie": "A"
  }'
```

### Node.js

```javascript
const res = await fetch("https://api.cfdi.express/v1/merchants", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.CFDI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    rfc: "EKU9003173C9",
    legalName: "ESCUELA KEMPER URGATE",
    regimenFiscal: "601",
    zip: "42501",
    serie: "A",
    defaultClaveProdServ: "01010101",
    defaultClaveUnidad: "E48",
  }),
});

const merchant = await res.json();
```

## Respuesta

### 201 Created

```json
{
  "id": "mkq2f8v3x1t7p9d4n6c0b5rz",
  "object": "merchant",
  "livemode": false,
  "rfc": "EKU9003173C9",
  "legalName": "ESCUELA KEMPER URGATE",
  "regimenFiscal": "601",
  "zip": "42501",
  "serie": "A",
  "defaultClaveProdServ": "01010101",
  "defaultClaveUnidad": "E48",
  "csd": null,
  "logoUrl": null,
  "createdAt": "2026-08-18T16:20:03.114Z"
}
```

## Errores

| Status | code | Cuándo aparece |
|---|---|---|
| 400 | `validation_error` | RFC mal formado, régimen fiscal inexistente o un emisor con ese RFC ya existe. El arreglo errors indica el campo. |
| 401 | `unauthorized` | Falta el header Authorization o la llave es inválida. |

## Relacionados

- [POST /v1/merchants/{id}/csd](https://cfdi.express/docs/api/subir-csd) — Subir CSD
- [GET /v1/merchants](https://cfdi.express/docs/api/listar-emisores) — Listar emisores
- [POST /v1/invoices](https://cfdi.express/docs/api/timbrar-factura) — Timbrar factura

---

Referencia completa: https://cfdi.express/docs/api · OpenAPI: https://api.cfdi.express/openapi.json · Llaves: https://dash.cfdi.express