Saltar al contenido
Facturador

Datos de un comprobante para su guía

GET /api/document/get-data/{document_id}

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

Devuelve los datos de un comprobante para armar su guía de remisión: establecimiento, cliente con sus direcciones, documento relacionado (listo para documento_relacionado) y líneas.

Quién puede usarlo: cualquier usuario autenticado (administrador o vendedor). No se restringe por vendedor: cualquier usuario puede operar sobre cualquier registro de la empresa.

Formato de respuesta: heredado {success, message?, data?} sin paginación. Ante reglas de negocio puede responder HTTP 200 con success: false: revisa siempre success. items son las líneas del comprobante con todas sus columnas.

Errores: HTTP 200 con {success: false, message: "No éxiste documento"} si el id no existe.

Parámetros

Parámetro Dónde Obligatorio Ejemplo Descripción
document_id ruta sí 1

Respuestas

200 — Datos

{
  "success": true,
  "data": {
    "document": {
      "establishment_id": 1,
      "customer_id": 1,
      "document_related": {
        "documento": {
          "id": "01",
          "descripcion": "Factura Electrónica"
        },
        "document_type_id": "01",
        "serie": "F001",
        "numero": "F001-1520",
        "empresa": "MI EMPRESA S.A.C.",
        "ruc": "20123456789"
      }
    },
    "items": [
      {
        "id": 3001,
        "document_id": 1520,
        "item_id": 120,
        "item": {
          "description": "GASEOSA 500ML",
          "internal_id": "P0121",
          "unit_type_id": "NIU"
        },
        "quantity": "2.0000",
        "unit_value": "50.000000",
        "unit_price": "59.000000",
        "affectation_igv_type_id": "10",
        "total_igv": "18.00",
        "total_value": "100.00",
        "total": "118.00"
      }
    ],
    "customer": {
      "id": 1,
      "description": "20501973522 - EMPRESA XYZ S.A.C.",
      "name": "EMPRESA XYZ S.A.C.",
      "number": "20501973522",
      "identity_document_type_id": "6",
      "identity_document_type_code": "6",
      "identity_document_type_description": "RUC",
      "address": "Av. 2 de Mayo 123, Lima",
      "telephone": "014271148",
      "country_id": "PE",
      "district_id": "150101",
      "email": "facturacion@xyz.com.pe",
      "selected": false,
      "addresses": [
        {
          "id": 4,
          "location_id": [
            "15",
            "1501",
            "150101"
          ],
          "address": "Jr. Ica 450, Lima",
          "code": "0001",
          "has_consigned": false
        }
      ]
    }
  },
  "message": "Documento encontrado con éxito"
}

200 — No existe

{
  "success": false,
  "message": "No éxiste documento"
}

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.