Saltar al contenido
Facturador

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:

  • 422 si falta un campo obligatorio, si description o code ya existen, o si email no 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.