Libro de reclamaciones

Registrar un reclamo en el libro de reclamaciones de la tienda.

2 min de lecturaActualizado el 30 de setiembre de 2026

Registrar un reclamo

POST /api/v1/ecommerce/claims/register

No pide token: cualquier visitante puede registrar un reclamo.

Cuerpo

Todos los campos son obligatorios.

Campo Tipo Reglas
first_name texto Máximo 100 caracteres
last_name texto Máximo 100 caracteres
document_type texto Tipo de documento de quien reclama. Máximo 255 caracteres. Acepta cualquier texto: no hay una lista cerrada y el ERP lo muestra tal cual en su lista de reclamos. Envía un nombre legible, por ejemplo DNI, RUC o CE
document_number texto Máximo 255 caracteres
email texto Email válido de hasta 200 caracteres
phone texto Máximo 255 caracteres
address texto Máximo 200 caracteres
department texto Nombre del departamento, en texto libre
province texto Nombre de la provincia, en texto libre
district texto Nombre del distrito, en texto libre
description texto Detalle del reclamo. Máximo 2000 caracteres
{
  "first_name": "Carlos",
  "last_name": "Ramírez",
  "document_type": "DNI",
  "document_number": "45678912",
  "email": "[email protected]",
  "phone": "987654321",
  "address": "Jr. Los Pinos 120",
  "department": "Lima",
  "province": "Lima",
  "district": "Surco",
  "description": "El pedido llegó incompleto."
}

Respuesta

{ "success": true, "message": "Reclamo guardado exitosamente.", "data": { "number": 154 } }

data.number es el número del reclamo. Muéstralo al cliente para que pueda hacer seguimiento.

Si algo sale mal

HTTP code Cuándo Qué hacer
422 VALIDATION_ERROR Falta un campo, el email no es válido o un texto es demasiado largo Corrige el campo que indica errors
500 INTERNAL_ERROR No se pudo guardar Reintenta. Si se repite, reporta la reference