Saltar al contenido
Facturador

Establecimientos con sus series

GET /api/establishments/series

Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).

Devuelve todos los establecimientos con sus series de factura (01), boleta (03), nota de venta (80) y guías (09, 31), más las series por defecto del usuario autenticado. Útil para que el sistema externo sepa con qué series_id emitir.

Quién puede usarlo: cualquier usuario autenticado (administrador o vendedor). Las series que se devuelven pueden estar limitadas a las del dispositivo o contexto del usuario.

Sin parámetros. Respuesta: data.establishments[] (id, description, address, trade_address, code, district_id, email, telephone, series[] con id, document_type_id, number, is_default) y data.default_document_types[] (id, series_id, document_type_id).

Respuestas

200 — Establecimientos y series

{
  "success": true,
  "data": {
    "establishments": [
      {
        "id": 1,
        "description": "Oficina Principal",
        "address": "AV. PRINCIPAL 123",
        "trade_address": null,
        "code": "0000",
        "district_id": "150101",
        "email": "ventas@empresa.com",
        "telephone": "014567890",
        "series": [
          {
            "id": 1,
            "document_type_id": "01",
            "number": "F001",
            "is_default": true
          },
          {
            "id": 2,
            "document_type_id": "03",
            "number": "B001",
            "is_default": true
          },
          {
            "id": 5,
            "document_type_id": "80",
            "number": "NV01",
            "is_default": false
          }
        ]
      }
    ],
    "default_document_types": [
      {
        "id": 1,
        "series_id": 1,
        "document_type_id": "01"
      }
    ]
  }
}

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.