Skip to main content
POST
Crear producto

Autorizaciones

x-api-key
string
header
requerido

API key del API Gateway de Tapi. Requerida en todas las operaciones. Distinta por ambiente (desarrollo, homologación, producción).

x-authorization-token
string
header
requerido

Token TAPI JWT. Requerido en todas las operaciones. Se envía sin prefijo "Bearer". Ej: x-authorization-token: eyJhbGci...

Cuerpo

application/json
name
string
requerido

Nombre del producto, único por company. Se recorta (trim). Si ya existe un producto activo con ese name, la API responde 201 con el producto existente sin modificarlo.

Minimum string length: 1
externalProductId
string

Identificador propio del producto (opcional). Es el que se usa para referenciarlo en POST /v2/debts via externalProductId. Se recorta (trim) y no admite los caracteres ', ", \, ; (400).

companyCode
string

Company de Tapi en la que se crea el producto (opcional). Solo aplica si tu cliente tiene varias companies: indica para cual de ellas es el producto. Debe ser una company de tu cliente (si no, 422 RESOLUTION_ERROR). Si tu cliente tiene una sola company, se omite; si tiene varias y no se envia, la API responde 400 pidiendolo.

Ejemplo:

"MX-S-04937"

active
boolean
predeterminado:true

Estado del producto. Default true al crear. Soft-delete lo pone en false. Crear con active=false devuelve el producto con active=false y createdAt/updatedAt en null; un producto inactivo no se puede leer ni usar después (ver Product).

Respuesta

Producto creado, o producto activo existente con el mismo name (sin modificar)

data
object
requestId
string