Crear establecimiento
POST /api/establishments
Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).
Registra un establecimiento y crea su almacén.
Quién puede usarlo: solo usuarios de tipo administrador (type = admin). Con el token de un vendedor responde 403.
| Campo | Tipo | Obligatorio | Descripción / valores permitidos |
|---|---|---|---|
description |
string | Sí | Nombre del establecimiento. Único en la empresa. |
code |
string | Sí (al crear) | Código de domicilio fiscal (anexo SUNAT), p. ej. 0000 para el domicilio fiscal o 0001, 0002... Único. No se puede cambiar al editar (se ignora). |
country_id |
string | No | Código de país. Por defecto PE. |
department_id |
string | Sí | Ubigeo del departamento (2 dígitos), p. ej. 15 = Lima. |
province_id |
string | Sí | Ubigeo de la provincia (4 dígitos), p. ej. 1501 = Lima. |
district_id |
string | Sí | Ubigeo del distrito (6 dígitos, código INEI/SUNAT), p. ej. 150122 = Miraflores, 150101 = Lima. |
address |
string | Sí | Dirección. |
telephone |
string | Sí | Teléfono. |
email |
string | No | Correo. Debe tener formato de correo válido (salvo que la empresa haya desactivado esa validación). |
trade_address |
string | No | Dirección comercial que se imprime en los comprobantes. |
web_address |
string | No | Página web. |
aditional_information |
string | No | Información adicional que se imprime en los comprobantes. |
customer_id |
integer | No | Cliente por defecto del establecimiento (id de cliente). |
template_pdf |
string | No | Plantilla PDF A4 (por defecto default). |
template_ticket_pdf |
string | No | Plantilla PDF ticket (por defecto default). |
has_igv_31556 |
boolean | No | true si el establecimiento aplica la tasa de IGV reducida de la Ley 31556. |
addresses |
array | No | Direcciones de partida para guías de remisión. Cada elemento: address (string), location_id (array [departamento, provincia, distrito]), is_default (bool), is_active (bool), establishment_code (string), country_id (string). Al editar, si se envía, reemplaza todas las direcciones existentes. |
Errores:
422si falta un campo obligatorio, sidescriptionocodeya existen, o siemailno es válido.
Almacén: al crear el establecimiento se crea automáticamente su almacén (con el mismo nombre). Consulta su id con GET /api/warehouses?establishment_id=<id>: no asumas que es igual al id del establecimiento.
Cuerpo
Content-Type: application/json
{
"description": "SUCURSAL MIRAFLORES",
"code": "0001",
"country_id": "PE",
"department_id": "15",
"province_id": "1501",
"district_id": "150122",
"address": "AV. LARCO 456",
"telephone": "014445566",
"email": "miraflores@empresa.com",
"trade_address": "AV. LARCO 456 - MIRAFLORES",
"web_address": "https://empresa.com",
"aditional_information": "Horario: lunes a sábado de 9 a 18 h",
"customer_id": null,
"template_pdf": "default",
"template_ticket_pdf": "default",
"has_igv_31556": false,
"addresses": [
{
"address": "AV. LARCO 456 - ALMACÉN",
"location_id": [
"15",
"1501",
"150122"
],
"is_default": true,
"is_active": true,
"establishment_code": "0001",
"country_id": "PE"
}
]
}
Respuestas
201 — Creado
{
"success": true,
"data": {
"id": 2,
"description": "SUCURSAL MIRAFLORES",
"country_id": "PE",
"department_id": "15",
"province_id": "1501",
"district_id": "150122",
"address": "AV. LARCO 456",
"addresses": [
{
"id": 3,
"address": "AV. LARCO 456 - ALMACÉN",
"location_id": [
"15",
"1501",
"150122"
],
"is_default": true,
"is_active": true,
"establishment_id": 2,
"establishment_code": "0001",
"country_id": "PE"
}
],
"telephone": "014445566",
"email": "miraflores@empresa.com",
"code": "0001",
"trade_address": "AV. LARCO 456 - MIRAFLORES",
"web_address": "https://empresa.com",
"aditional_information": "Horario: lunes a sábado de 9 a 18 h",
"customer_id": null,
"customer_number": null,
"logo": null,
"has_igv_31556": false,
"template_pdf": "default",
"template_ticket_pdf": "default",
"department": "LIMA",
"province": "LIMA",
"district": "MIRAFLORES",
"warehouse_id": 2
},
"message": "Establecimiento registrado"
}
422 — Código repetido
{
"success": false,
"message": {
"code": [
"El código de domicilio fiscal ingresado ya existe. Por favor ingrese uno nuevo"
]
}
}
Pruébalo
Prueba este endpoint con tu empresa y tu token: elige la URL en Servers, pega el token en Authorize y haz clic en Try it out.