Crear un proveedor

Referencia › Crear un proveedor

Proveedores

# Crear un proveedor

POST https://api.wizerp.com/api/v1/proveedores

Da de alta un proveedor en tu padrón. La empresa sale de tu llave.

Necesita nombre. El RFC es opcional, pero si lo mandas y no es genérico (XAXX010101000 / XEXX010101000), no se permite repetirlo entre tus proveedores activos: un RFC ya dado de alta responde 409. También se checa contra la lista 69-B del SAT (RFC con operaciones presuntamente inexistentes); si está ahí, responde 422 salvo que mandes permitir_efos: true.

No se pueden escribir la empresa, el folio, el estatus, las cuentas bancarias ni el saldo a favor: son datos de identidad y de dinero. Las empresas en esquema de franquicia no pueden usar esta operación aún.

Toda escritura necesita la cabecera Idempotency-Key: un valor único por operación (por ejemplo un UUID) que repites tal cual al reintentar. Con la misma clave y los mismos datos se devuelve la respuesta guardada, sin duplicar; con la misma clave y datos distintos responde 409.

Permiso: proveedores:write

## Cuerpo JSON
- `nombre` (texto): Nombre o razón social. Obligatorio. Máximo 100.
- `rfc` (texto): RFC válido. No puede repetir el de otro proveedor activo de tu empresa; se checa contra la lista 69-B del SAT (EFOS).
- `curp` (texto): CURP, si el proveedor es persona física. Máximo 20.
- `correo` (texto): Uno o varios correos separados por coma; cada uno se valida. Máximo 500. Manda null para borrarlo.
- `telefono` (texto): Teléfono. Máximo 30.
- `calle` (texto): Calle y número. Máximo 200.
- `colonia` (texto): Colonia. Máximo 50.
- `cp` (texto): Código postal de 5 dígitos, como texto ("01000").
- `pais` (entero): Clave de país (172 = México por omisión, igual que en /clientes).
- `dias_credito` (entero): Días de crédito del proveedor. Entero mayor o igual a 0, o null para dejarlo sin definir.
- `id_fiscal` (texto): Identificador fiscal del extranjero (proveedores sin RFC mexicano). Máximo 20.
- `sin_parte_relacionada` (booleano): true = el proveedor NO es parte relacionada (el valor por omisión del ERP). false = sí lo es.
- `permitir_efos` (booleano): Da de alta o edita aunque el RFC esté en la lista 69-B del SAT. Por omisión false: ese RFC responde 422.

POST https://api.wizerp.com/api/v1/proveedores

https://api.wizerp.com/api/v1/proveedores

Da de alta un proveedor en tu padrón. La empresa sale de tu llave.

Necesita nombre. El RFC es opcional, pero si lo mandas y no es genérico (XAXX010101000 / XEXX010101000), no se permite repetirlo entre tus proveedores activos: un RFC ya dado de alta responde 409. También se checa contra la lista 69-B del SAT (RFC con operaciones presuntamente inexistentes); si está ahí, responde 422 salvo que mandes permitir_efos: true.

No se pueden escribir la empresa, el folio, el estatus, las cuentas bancarias ni el saldo a favor: son datos de identidad y de dinero. Las empresas en esquema de franquicia no pueden usar esta operación aún.

Toda escritura necesita la cabecera Idempotency-Key: un valor único por operación (por ejemplo un UUID) que repites tal cual al reintentar. Con la misma clave y los mismos datos se devuelve la respuesta guardada, sin duplicar; con la misma clave y datos distintos responde 409.

Requiere el permiso proveedores:write en la llave · contrato del 2026-10-12

Cuerpo JSON

Además, toda escritura necesita la cabecera Idempotency-Key: un valor único por operación (por ejemplo un UUID) que repites tal cual al reintentar.

nombre texto obligatorio

Nombre o razón social. Obligatorio. Máximo 100.

rfc texto

RFC válido. No puede repetir el de otro proveedor activo de tu empresa; se checa contra la lista 69-B del SAT (EFOS).

curp texto

CURP, si el proveedor es persona física. Máximo 20.

correo texto

Uno o varios correos separados por coma; cada uno se valida. Máximo 500. Manda null para borrarlo.

telefono texto

Teléfono. Máximo 30.

calle texto

Calle y número. Máximo 200.

colonia texto

Colonia. Máximo 50.

cp texto

Código postal de 5 dígitos, como texto ("01000").

pais entero

Clave de país (172 = México por omisión, igual que en /clientes).

dias_credito entero

Días de crédito del proveedor. Entero mayor o igual a 0, o null para dejarlo sin definir.

id_fiscal texto

Identificador fiscal del extranjero (proveedores sin RFC mexicano). Máximo 20.

sin_parte_relacionada booleano

true = el proveedor NO es parte relacionada (el valor por omisión del ERP). false = sí lo es.

permitir_efos booleano

Da de alta o edita aunque el RFC esté en la lista 69-B del SAT. Por omisión false: ese RFC responde 422.

Respuestas

400 Petición mal formada: filtro no permitido, filtro vacío, cursor o límite inválidos, o una cabecera de navegador

401 La llave no es válida, está revocada o venció (llave_invalida), o el usuario dueño de la llave ya no tiene acceso a la empresa (llave_sin_titular)

402 Tu empresa no tiene un plan Pro vigente (plan_requerido). Mientras los límites estén en modo de aviso, esta situación sigue contestando 401 llave_invalida

403 La llave no tiene el permiso que pide esta operación (sin_permiso), o no tiene aceptados los términos de uso de la API vigentes (terminos_pendientes: acéptalos en Wizerp, Configuración › Llaves de API)

404 La ruta no existe, o tu empresa no tiene la API habilitada

409 Conflicto: misma Idempotency-Key con datos distintos, o ya existe un registro con ese identificador (RFC, SKU)

413 El cuerpo pasa del máximo

415 El cuerpo no va como JSON (falta Content-Type: application/json)

422 Un dato no es válido para tu empresa

429 Pasaste el ritmo de 150 peticiones por minuto de tu llave (limite_excedido) o el cupo mensual de tu empresa (cupo_agotado). La respuesta trae Retry-After

500 Falló de nuestro lado. Reintenta y reporta el valor de peticion

503 Tu empresa tiene demasiadas peticiones en curso, o la búsqueda no está disponible. Trae Retry-After

Lenguaje

Petición · cURL

curl -X POST https://api.wizerp.com/api/v1/proveedores \
  -H "Authorization: Bearer wzk_live_…" \
  -H "X-Wizerp-Key-Id: 208_a3f91c7d" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 3fa85f64-5717-4562-b3fc-2c963f66afa6" \
  -d '{"nombre":"Papelería Industrial del Norte S.A. de C.V.","rfc":"PIN150612AB3","correo":"compras@papelind.mx","telefono":"81 2233 4455","dias_credito":30}'

$ch = curl_init('https://api.wizerp.com/api/v1/proveedores');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer wzk_live_…',
    'X-Wizerp-Key-Id: 208_a3f91c7d',
    'Content-Type: application/json',
    'Idempotency-Key: 3fa85f64-5717-4562-b3fc-2c963f66afa6',
]);
curl_setopt($ch, CURLOPT_POSTFIELDS,
    '{"nombre":"Papelería Industrial del Norte S.A. de C.V.","rfc":"PIN150612AB3","correo":"compras@papelind.mx","telefono":"81 2233 4455","dias_credito":30}');
$r = json_decode(curl_exec($ch), true);

const r = await fetch(
  "https://api.wizerp.com/api/v1/proveedores",
  {
    method: "POST",
    headers: {
      Authorization: "Bearer wzk_live_…",
      "X-Wizerp-Key-Id": "208_a3f91c7d",
      "Content-Type": "application/json",
      "Idempotency-Key": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    },
    body: JSON.stringify({"nombre":"Papelería Industrial del Norte S.A. de C.V.","rfc":"PIN150612AB3","correo":"compras@papelind.mx","telefono":"81 2233 4455","dias_credito":30}),
  }
);
const datos = await r.json();

import requests

r = requests.post(
    "https://api.wizerp.com/api/v1/proveedores",
    headers={
        "Authorization": "Bearer wzk_live_…",
        "X-Wizerp-Key-Id": "208_a3f91c7d",
        "Idempotency-Key": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    },
    json={"nombre":"Papelería Industrial del Norte S.A. de C.V.","rfc":"PIN150612AB3","correo":"compras@papelind.mx","telefono":"81 2233 4455","dias_credito":30},
)
datos = r.json()

Las escrituras se prueban desde tu propio sistema con tu llave; la consola pública es solo para consultas. Copia el ejemplo de arriba: ya lleva el cuerpo y la cabecera Idempotency-Key.

Respuesta elige un ejemplo

{
    "ok": true,
    "proveedor": 184027,
    "folio": "texto",
    "rfc": "texto"
}

{
    "ok": false,
    "error": {
        "codigo": "json_invalido",
        "mensaje": "Petición mal formada: filtro no permitido, filtro vacío, cursor o límite inválidos, o una cabecera de navegador",
        "peticion": "req_dca2d22e3324f9a8"
    }
}

{
    "ok": false,
    "error": {
        "codigo": "llave_invalida",
        "mensaje": "La llave no es válida, está revocada o venció (llave_invalida), o el usuario dueño de la llave ya no tiene acceso a la empresa (llave_sin_titular)",
        "peticion": "req_dca2d22e3324f9a8"
    }
}

{
    "ok": false,
    "error": {
        "codigo": "limite_excedido",
        "mensaje": "Pasaste el ritmo de 150 peticiones por minuto de tu llave (limite_excedido) o el cupo mensual de tu empresa (cupo_agotado). La respuesta trae Retry-After",
        "peticion": "req_dca2d22e3324f9a8"
    }
}

Ver la referencia completa