Libro de reclamaciones
Registrar un reclamo en el libro de reclamaciones de la tienda.
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 |