{
  "info": {
    "name": "API Gateway CG [Calidad] [v14]",
    "description": "API de Facturación — CG Imprenta Digital. Generada desde la documentación (doc-site). Ejecuta primero \"Solicitar token\": guarda {{token}} para el resto. Cambia {{host}} según el ambiente.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "auth": {
    "type": "bearer",
    "bearer": [
      {
        "key": "token",
        "value": "{{token}}",
        "type": "string"
      }
    ]
  },
  "variable": [
    {
      "key": "host",
      "value": "https://calidad.cgimprenta.digital/"
    },
    {
      "key": "token",
      "value": ""
    }
  ],
  "item": [
    {
      "name": "Autenticación",
      "item": [
        {
          "name": "Solicitar token",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{host}}api/Invoice/create_token_authenticator",
              "host": [
                "{{host}}"
              ],
              "path": [
                "api",
                "Invoice",
                "create_token_authenticator"
              ]
            },
            "description": "Genera el token JWT de acceso del negocio emisor. Es el único endpoint que no requiere token: el resto del API exige enviarlo en el encabezado `Authorization`. Devuelve el token en la clave `token`.\n\nDocumentación: {{host}}doc/endpoints/token.html",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"userName\": \"usuario@example.com\",\n  \"userPassword\": \"<contraseña de API>\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "auth": {
              "type": "noauth"
            }
          },
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "// Guarda el token para las demás solicitudes",
                  "const j = pm.response.json();",
                  "if (j && j.token) { pm.collectionVariables.set(\"token\", j.token); }"
                ]
              }
            }
          ]
        }
      ]
    },
    {
      "name": "Consultas",
      "item": [
        {
          "name": "Métodos de pago",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{host}}api/Invoice/payments_methods",
              "host": [
                "{{host}}"
              ],
              "path": [
                "api",
                "Invoice",
                "payments_methods"
              ]
            },
            "description": "Devuelve el catálogo de métodos de pago que acepta el API (por ejemplo, transferencia, efectivo, pago móvil, divisa). Úsalo para saber qué valores enviar en `order_payment_methods[].order_payment_method` al emitir documentos.\n\nDocumentación: {{host}}doc/endpoints/metodos-de-pago.html"
          }
        },
        {
          "name": "Bancos",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{host}}api/Invoice/banks?search_text=0134",
              "host": [
                "{{host}}"
              ],
              "path": [
                "api",
                "Invoice",
                "banks"
              ],
              "query": [
                {
                  "key": "search_text",
                  "value": "0134"
                }
              ]
            },
            "description": "Devuelve el catálogo de bancos venezolanos registrados, con su código de 4 dígitos y su nombre. Úsalo para saber qué valor enviar en el campo `banco` de los pagos (`order_payment_methods[]`) al emitir documentos.\n\nDocumentación: {{host}}doc/endpoints/bancos.html"
          }
        },
        {
          "name": "Ver facturas",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{host}}api/Invoice/get_list_invoices?fechaInicio=2026-01-01&fechaFin=2026-01-31&tipoDeIdentificacion=V&identificacionCliente=12345678&limite=20&pagina=1",
              "host": [
                "{{host}}"
              ],
              "path": [
                "api",
                "Invoice",
                "get_list_invoices"
              ],
              "query": [
                {
                  "key": "fechaInicio",
                  "value": "2026-01-01"
                },
                {
                  "key": "fechaFin",
                  "value": "2026-01-31"
                },
                {
                  "key": "tipoDeIdentificacion",
                  "value": "V"
                },
                {
                  "key": "identificacionCliente",
                  "value": "12345678"
                },
                {
                  "key": "limite",
                  "value": "20"
                },
                {
                  "key": "pagina",
                  "value": "1"
                }
              ]
            },
            "description": "Lista los documentos fiscales emitidos por el negocio del token, con su número, número de control, cliente, estado y enlace al PDF. Admite filtros por número de documento, rango de fechas y cliente, y paginación.\n\nDocumentación: {{host}}doc/endpoints/facturas.html"
          }
        },
        {
          "name": "Consultar clientes",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{host}}api/Invoice/get_clients",
              "host": [
                "{{host}}"
              ],
              "path": [
                "api",
                "Invoice",
                "get_clients"
              ]
            },
            "description": "Devuelve los clientes activos registrados en el negocio del token. Puedes filtrar por RIF/cédula, nombre o correo; si no envías filtros, devuelve todos. Los datos vienen con los mismos nombres de campo que usas al emitir documentos.\n\nDocumentación: {{host}}doc/endpoints/clientes.html",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"rif\": \"J123456789\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        }
      ]
    },
    {
      "name": "Documentos fiscales",
      "item": [
        {
          "name": "Factura",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{host}}api/Invoice/add_list_invoice",
              "host": [
                "{{host}}"
              ],
              "path": [
                "api",
                "Invoice",
                "add_list_invoice"
              ]
            },
            "description": "Emite una o varias facturas fiscales en una sola llamada. A cada factura se le asigna el siguiente número de control disponible del negocio, se registra el cliente y los productos que aún no existan, se guardan los pagos (o la factura queda **a crédito** si no se envían) y se devuelve el enlace al PDF de cada factura emitida.\n\nDocumentación: {{host}}doc/endpoints/factura.html",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"numeroSerie\": \"A\",\n  \"cantidadFactura\": 1,\n  \"facturas\": [\n    {\n      \"numeroFactura\": \"000123\",\n      \"descripcionFactura\": \"Servicio de mantenimiento mensual\",\n      \"documentoIdentidadCliente\": \"J123456789\",\n      \"nombreRazonSocialCliente\": \"Cliente Ejemplo C.A.\",\n      \"correoCliente\": \"facturacion@example.com\",\n      \"direccionCliente\": \"Av. Principal, Caracas\",\n      \"telefonoCliente\": \"04141234567\",\n      \"tasa_del_dia\": \"342.8633\",\n      \"fecha_tasa\": \"09-10-2026\",\n      \"mostrar_formas_de_pago\": 1,\n      \"productos\": [\n        {\n          \"codigoProducto\": \"SERV-001\",\n          \"nombreProducto\": \"Mantenimiento preventivo\",\n          \"descripcionProducto\": \"Mantenimiento preventivo de equipos\",\n          \"product_note\": \"Incluye visita técnica\",\n          \"tipoImpuesto\": \"G\",\n          \"cantidadAdquirida\": \"1\",\n          \"precioProducto\": \"1000.00\",\n          \"discount\": 0\n        }\n      ],\n      \"order_payment_methods\": [\n        {\n          \"order_payment_method\": \"transferencia\",\n          \"monto\": \"1160.00\",\n          \"banco\": \"Banco de Venezuela\",\n          \"numero_de_referencia_de_operacion\": \"1234\"\n        }\n      ]\n    }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Factura a terceros",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{host}}api/Invoice/add_list_invoice_third_party",
              "host": [
                "{{host}}"
              ],
              "path": [
                "api",
                "Invoice",
                "add_list_invoice_third_party"
              ]
            },
            "description": "Emite facturas de **venta por cuenta de terceros**: cada factura debe tener al menos un producto vendido a cuenta de un tercero (identificado con `rifTercero` y `nombreRifTercero`) y puede combinarlo con productos propios. Devuelve el número de control asignado y el enlace al PDF de terceros de cada factura. El negocio debe tener activada la facturación a terceros.\n\nDocumentación: {{host}}doc/endpoints/factura-terceros.html",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"numeroSerie\": \"A\",\n  \"cantidadFactura\": 1,\n  \"facturas\": [\n    {\n      \"numeroFactura\": \"001083\",\n      \"descripcionFactura\": \"Factura mixta (cuenta propia y cuenta de terceros)\",\n      \"tasa_del_dia\": \"342.8633\",\n      \"fecha_tasa\": \"2026-10-09\",\n      \"documentoIdentidadCliente\": \"J123456789\",\n      \"nombreRazonSocialCliente\": \"Cliente Ejemplo C.A.\",\n      \"correoCliente\": \"cliente@example.com\",\n      \"direccionCliente\": \"Av. Principal, Caracas\",\n      \"telefonoCliente\": \"04141234567\",\n      \"productos\": [\n        {\n          \"codigoProducto\": \"PROD-002\",\n          \"nombreProducto\": \"Mercancía de tercero\",\n          \"descripcionProducto\": \"Venta a cuenta de tercero\",\n          \"tipoImpuesto\": \"G\",\n          \"cantidadAdquirida\": \"100\",\n          \"precioProducto\": \"150.00\",\n          \"rifTercero\": \"J987654321\",\n          \"nombreRifTercero\": \"Tercero Ejemplo C.A.\"\n        },\n        {\n          \"codigoProducto\": \"FEE-001\",\n          \"nombreProducto\": \"Comisión de servicio\",\n          \"descripcionProducto\": \"Comisión por intermediación\",\n          \"tipoImpuesto\": \"G\",\n          \"cantidadAdquirida\": \"1\",\n          \"precioProducto\": \"500.00\"\n        }\n      ],\n      \"order_payment_methods\": [\n        {\n          \"order_payment_method\": \"transferencia\",\n          \"monto\": \"17980.00\",\n          \"banco\": \"Banco de Venezuela\",\n          \"numero_de_referencia_de_operacion\": \"1234\"\n        }\n      ]\n    }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Nota de crédito",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{host}}api/Invoice/add_credit_note",
              "host": [
                "{{host}}"
              ],
              "path": [
                "api",
                "Invoice",
                "add_credit_note"
              ]
            },
            "description": "Emite una **nota de crédito total** sobre una factura ya emitida por el negocio. La nota copia\ntodos los productos, bases, impuestos y totales de la factura afectada, recibe un número de\ncontrol y se firma electrónicamente. Devuelve el número de control asignado y el enlace al PDF.\n\nDocumentación: {{host}}doc/endpoints/nota-credito.html",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"numeroFactura\": \"005172\",\n  \"numeroNotaCredito\": \"000024\",\n  \"descripcion\": \"Devolución total de la mercancía\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Nota de crédito parcial",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{host}}api/Invoice/add_credit_note_with_products",
              "host": [
                "{{host}}"
              ],
              "path": [
                "api",
                "Invoice",
                "add_credit_note_with_products"
              ]
            },
            "description": "Emite una **nota de crédito por productos y cantidades concretas** de una factura ya emitida.\nPuedes emitir varias notas parciales sobre la misma factura hasta acreditar todas sus\ncantidades. Devuelve el número de control, el PDF y el estado de lo acreditado y lo que queda\ndisponible por producto.\n\nDocumentación: {{host}}doc/endpoints/nota-credito-parcial.html",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"numeroFactura\": \"000180\",\n  \"numeroNotaCredito\": \"000076\",\n  \"descripcion\": \"Devolución parcial de mercancía\",\n  \"productos\": [\n    {\n      \"codigo\": \"PT-0001\",\n      \"descripcion\": \"PAPEL TOILET\",\n      \"cantidad\": \"2.00\"\n    },\n    {\n      \"codigo\": \"CI-0001\",\n      \"descripcion\": \"CAFE INSTANTANEO\",\n      \"cantidad\": \"1\"\n    }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Nota de débito",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{host}}api/Invoice/add_debit_note",
              "host": [
                "{{host}}"
              ],
              "path": [
                "api",
                "Invoice",
                "add_debit_note"
              ]
            },
            "description": "Emite una **nota de débito** sobre una factura ya emitida, con productos o conceptos nuevos que\naumentan el monto adeudado (cargos adicionales, intereses, diferencias de precio, etc.). La nota\nrecibe un número de control, se firma electrónicamente y puede registrar sus métodos de pago.\nDevuelve el número de control y el enlace al PDF.\n\nDocumentación: {{host}}doc/endpoints/nota-debito.html",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"numeroFactura\": \"000313\",\n  \"numeroNotaDebito\": \"000021\",\n  \"descripcion\": \"Cargo por flete adicional\",\n  \"tasa_del_dia\": \"342.8633\",\n  \"fecha_tasa\": \"21-10-2026\",\n  \"productos_nuevos\": [\n    {\n      \"codigoProducto\": \"FLETE-01\",\n      \"nombreProducto\": \"FLETE\",\n      \"descripcionProducto\": \"FLETE ADICIONAL CARACAS - VALENCIA\",\n      \"tipoImpuesto\": \"G\",\n      \"cantidadAdquirida\": 1,\n      \"precioProducto\": \"100,00\"\n    }\n  ],\n  \"order_payment_methods\": [\n    {\n      \"order_payment_method\": \"transferencia\",\n      \"monto\": \"116.00\",\n      \"banco\": \"Banco de Venezuela\",\n      \"numero_de_referencia_de_operacion\": \"4821\"\n    }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Orden de entrega",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{host}}api/Invoice/add_list_delivery",
              "host": [
                "{{host}}"
              ],
              "path": [
                "api",
                "Invoice",
                "add_list_delivery"
              ]
            },
            "description": "Emite **órdenes (notas) de entrega asociadas a facturas ya emitidas**. Cada orden copia los\nproductos y totales de su factura y registra el traslado: origen, destino, vehículo, chofer y\ndespachador. Cada orden recibe un número de control y se firma electrónicamente. Devuelve, por\ncada orden guardada, su número de control y el enlace al PDF.\n\nDocumentación: {{host}}doc/endpoints/orden-entrega.html",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"numeroSerie\": \"A\",\n  \"notasDeEntregas\": [\n    {\n      \"numeroFacturaAfectar\": \"000050\",\n      \"numeroDeNotaDeEntrega\": \"000003\",\n      \"origen\": \"Almacén principal, Caracas\",\n      \"destino\": \"Sucursal Valencia\",\n      \"vehiculo\": {\n        \"placaVehiculo\": \"AB123CD\",\n        \"tipoVehiculo\": \"CAMION\",\n        \"colorVehiculo\": \"BLANCO\",\n        \"codigoVehiculo\": \"CAM-002\"\n      },\n      \"empleados\": [\n        {\n          \"nombre\": \"Pedro\",\n          \"apellido\": \"Pérez\",\n          \"DocumentoIdentidad\": \"V12345678\",\n          \"cargo\": \"chofer\",\n          \"correo\": \"chofer@example.com\"\n        },\n        {\n          \"nombre\": \"Ana\",\n          \"apellido\": \"Gómez\",\n          \"DocumentoIdentidad\": \"V87654321\",\n          \"cargo\": \"despachador\",\n          \"correo\": \"despachador@example.com\"\n        }\n      ]\n    }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Orden de entrega individual",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{host}}api/Invoice/add_list_delivery_independent",
              "host": [
                "{{host}}"
              ],
              "path": [
                "api",
                "Invoice",
                "add_list_delivery_independent"
              ]
            },
            "description": "Emite **órdenes (notas) de entrega independientes**, es decir, que no dependen de una factura:\nenvías el cliente, los productos y los datos del traslado (origen, destino, vehículo, chofer y\ndespachador). Admite varias órdenes por solicitud; cada una recibe un número de control y se\nfirma electrónicamente. Devuelve, por cada orden guardada, su número de control y el PDF.\n\nDocumentación: {{host}}doc/endpoints/orden-entrega-individual.html",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"numeroSerie\": \"A\",\n  \"cantidadNE\": 1,\n  \"notasDeEntregas\": [\n    {\n      \"numeroDeNotaDeEntrega\": \"000101\",\n      \"documentoIdentidadCliente\": \"J123456789\",\n      \"nombreRazonSocialCliente\": \"Cliente Ejemplo C.A.\",\n      \"correoCliente\": \"compras@example.com\",\n      \"direccionCliente\": \"Av. Principal, Edificio Ejemplo, Caracas\",\n      \"telefonoCliente\": \"04141234567\",\n      \"origen\": \"Almacén principal, Caracas\",\n      \"destino\": \"Sucursal Valencia\",\n      \"productos\": [\n        {\n          \"codigoProducto\": \"PROD-001\",\n          \"nombreProducto\": \"PRODUCTO A\",\n          \"descripcionProducto\": \"PRODUCTO A PRESENTACION 1 KG\",\n          \"tipoImpuesto\": \"G\",\n          \"cantidadAdquirida\": \"10.00\",\n          \"precioProducto\": \"150.00\"\n        },\n        {\n          \"codigoProducto\": \"PROD-002\",\n          \"nombreProducto\": \"PRODUCTO B\",\n          \"descripcionProducto\": \"PRODUCTO B EXENTO\",\n          \"tipoImpuesto\": \"E\",\n          \"cantidadAdquirida\": \"5\",\n          \"precioProducto\": \"80,00\"\n        }\n      ],\n      \"empleados\": [\n        {\n          \"nombre\": \"Pedro\",\n          \"apellido\": \"Pérez\",\n          \"DocumentoIdentidad\": \"V12345678\",\n          \"cargo\": \"chofer\",\n          \"correo\": \"chofer@example.com\"\n        },\n        {\n          \"nombre\": \"Ana\",\n          \"apellido\": \"Gómez\",\n          \"DocumentoIdentidad\": \"V87654321\",\n          \"cargo\": \"despachador\",\n          \"correo\": \"despachador@example.com\"\n        }\n      ],\n      \"vehiculo\": {\n        \"placaVehiculo\": \"AB123CD\",\n        \"tipoVehiculo\": \"CAMION\",\n        \"colorVehiculo\": \"BLANCO\",\n        \"codigoVehiculo\": \"CAM-001\"\n      }\n    }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Guía de despacho",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{host}}api/Invoice/add_list_dispatch_guide",
              "host": [
                "{{host}}"
              ],
              "path": [
                "api",
                "Invoice",
                "add_list_dispatch_guide"
              ]
            },
            "description": "Emite **guías de despacho**: documentos que acompañan el traslado de mercancía a un cliente.\nEnvías el cliente, los productos, el origen y destino, el vehículo, el chofer y el despachador.\nAdmite varias guías por solicitud; cada una recibe un número de control y se firma\nelectrónicamente. Devuelve, por cada guía guardada, su número de control y el enlace al PDF.\n\nDocumentación: {{host}}doc/endpoints/guia-despacho.html",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"numeroSerie\": \"A\",\n  \"cantidadGDP\": 1,\n  \"guiasDeDespacho\": [\n    {\n      \"numeroDeGuiaDeDespacho\": \"000047\",\n      \"documentoIdentidadCliente\": \"J123456789\",\n      \"nombreRazonSocialCliente\": \"Cliente Ejemplo C.A.\",\n      \"correoCliente\": \"compras@example.com\",\n      \"direccionCliente\": \"Av. Principal, Edificio Ejemplo, Caracas\",\n      \"telefonoCliente\": \"04141234567\",\n      \"origen\": \"Almacén principal, Guarenas\",\n      \"destino\": \"La Guaira\",\n      \"productos\": [\n        {\n          \"codigoProducto\": \"CAF-0001\",\n          \"nombreProducto\": \"CAFE\",\n          \"descripcionProducto\": \"CAFE MOLIDO 500 G\",\n          \"tipoImpuesto\": \"G\",\n          \"cantidadAdquirida\": 10,\n          \"precioProducto\": \"2,55\"\n        }\n      ],\n      \"empleados\": [\n        {\n          \"nombre\": \"Pedro\",\n          \"apellido\": \"Pérez\",\n          \"DocumentoIdentidad\": \"V12345678\",\n          \"cargo\": \"chofer\",\n          \"correo\": \"chofer@example.com\"\n        },\n        {\n          \"nombre\": \"Ana\",\n          \"apellido\": \"Gómez\",\n          \"DocumentoIdentidad\": \"V87654321\",\n          \"cargo\": \"despachador\",\n          \"correo\": \"despachador@example.com\"\n        }\n      ],\n      \"vehiculo\": {\n        \"placaVehiculo\": \"AB123CD\",\n        \"tipoVehiculo\": \"CAMION\",\n        \"colorVehiculo\": \"ROJO\",\n        \"codigoVehiculo\": \"CAM-001\"\n      }\n    }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Guía de despacho opcional",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{host}}api/Invoice/add_list_dispatch_guide_optional",
              "host": [
                "{{host}}"
              ],
              "path": [
                "api",
                "Invoice",
                "add_list_dispatch_guide_optional"
              ]
            },
            "description": "Emite **guías de despacho en las que el chofer, el despachador y el vehículo son opcionales**.\nEs la misma emisión que [Guía de despacho](/endpoints/guia-despacho) (mismo cuerpo, mismas\nreglas, misma respuesta y mismos errores); úsala cuando esos datos aún no se conocen al emitir.\n\nDocumentación: {{host}}doc/endpoints/guia-despacho-opcional.html",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"numeroSerie\": \"A\",\n  \"cantidadGDP\": 1,\n  \"guiasDeDespacho\": [\n    {\n      \"numeroDeGuiaDeDespacho\": \"123456\",\n      \"documentoIdentidadCliente\": \"V12345678\",\n      \"nombreRazonSocialCliente\": \"Cliente Ejemplo C.A.\",\n      \"correoCliente\": \"cliente@example.com\",\n      \"direccionCliente\": \"Av. Principal, Caracas\",\n      \"telefonoCliente\": \"04141234567\",\n      \"origen\": \"Almacén central\",\n      \"destino\": \"Oficina del cliente\",\n      \"productos\": [\n        {\n          \"codigoProducto\": \"PROD-01\",\n          \"nombreProducto\": \"PRODUCTO DE PRUEBA\",\n          \"descripcionProducto\": \"PRODUCTO DE PRUEBA 1 UNIDAD\",\n          \"tipoImpuesto\": \"G\",\n          \"cantidadAdquirida\": \"2\",\n          \"precioProducto\": \"150.50\"\n        }\n      ]\n    }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        }
      ]
    },
    {
      "name": "Productos y clientes",
      "item": [
        {
          "name": "Registrar productos",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{host}}api/Invoice/add_products",
              "host": [
                "{{host}}"
              ],
              "path": [
                "api",
                "Invoice",
                "add_products"
              ]
            },
            "description": "Registra o actualiza productos en el catálogo de su negocio. Si el `codigoProducto` ya existe se actualizan sus datos; si no, se crea. La operación es **todo o nada**: si algún producto tiene errores, no se guarda ninguno.\n\nDocumentación: {{host}}doc/endpoints/productos.html",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"productos\": [\n    {\n      \"codigoProducto\": \"PROD001\",\n      \"nombreProducto\": \"Laptop 14 pulgadas\",\n      \"descripcionProducto\": \"Laptop de alta gama con procesador i7\",\n      \"tipoImpuesto\": \"G\",\n      \"precio\": \"1200.50\"\n    },\n    {\n      \"codigoProducto\": \"PROD002\",\n      \"nombreProducto\": \"Libro de texto\",\n      \"descripcionProducto\": \"Libro escolar\",\n      \"tipoImpuesto\": \"E\",\n      \"precio\": \"25.75\"\n    }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Registrar clientes",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{host}}api/Invoice/add_clients",
              "host": [
                "{{host}}"
              ],
              "path": [
                "api",
                "Invoice",
                "add_clients"
              ]
            },
            "description": "Registra o actualiza clientes en la cartera de su negocio. Si ya existe un cliente con el mismo número de documento se actualizan sus datos; si no, se crea. La operación es **todo o nada**: si algún cliente tiene errores, no se guarda ninguno.\n\nDocumentación: {{host}}doc/endpoints/registrar-clientes.html",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"clientes\": [\n    {\n      \"documentoIdentidadCliente\": \"J123456789\",\n      \"nombreRazonSocialCliente\": \"Cliente Ejemplo C.A.\",\n      \"correoCliente\": \"contacto@example.com\",\n      \"telefonoCliente\": \"04141234567\",\n      \"direccionCliente\": \"Av. Principal, Caracas\"\n    },\n    {\n      \"documentoIdentidadCliente\": \"V12345678\",\n      \"nombreRazonSocialCliente\": \"Persona Ejemplo\",\n      \"correoCliente\": \"persona@example.com\",\n      \"telefonoCliente\": \"04241234567\",\n      \"direccionCliente\": \"Valencia, Carabobo\"\n    }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        }
      ]
    },
    {
      "name": "Retenciones",
      "item": [
        {
          "name": "Retención de IVA",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{host}}api/Invoice/add_retention_iva",
              "host": [
                "{{host}}"
              ],
              "path": [
                "api",
                "Invoice",
                "add_retention_iva"
              ]
            },
            "description": "Emite uno o varios comprobantes de retención de IVA. Cada elemento de `data` corresponde a un\nproveedor (el \"cliente\" del comprobante) con hasta 3 líneas de retención. Por cada proveedor se\nasigna un número de control y un número de comprobante, y se devuelve el enlace al PDF.\n\nDocumentación: {{host}}doc/endpoints/retencion-iva.html",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"data\": [\n    {\n      \"cliente\": [\n        {\n          \"documentoIdentidadCliente\": \"J123456789\",\n          \"nombreRazonSocialCliente\": \"Cliente Ejemplo C.A.\",\n          \"correoCliente\": \"proveedor@example.com\",\n          \"direccionCliente\": \"Av. Principal, Caracas\",\n          \"telefonoCliente\": \"04141234567\"\n        }\n      ],\n      \"RetencionIva\": [\n        {\n          \"fechaDeFactura\": \"2026-07-10\",\n          \"numeroFactura\": \"000123\",\n          \"numeroControl\": \"00-0000123\",\n          \"numeroNotaDeDebito\": \"N/A\",\n          \"numeroNotaDeCredito\": \"N/A\",\n          \"numeroFacturaAfectada\": \"N/A\",\n          \"totalDeCompraIncluyendoIva\": \"1.160,00\",\n          \"compraSinDerechoACreditoFiscal\": \"0,00\",\n          \"baseImponible\": \"1.000,00\",\n          \"porcentaje_iva\": \"16.00%\",\n          \"porcentaje\": \"75%\"\n        }\n      ]\n    }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Retención de ISLR",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{host}}api/Invoice/add_retention_islr",
              "host": [
                "{{host}}"
              ],
              "path": [
                "api",
                "Invoice",
                "add_retention_islr"
              ]
            },
            "description": "Emite uno o varios comprobantes de retención de ISLR (impuesto sobre la renta). Cada elemento de\n`data` corresponde a un proveedor con hasta 3 líneas de retención. Por cada proveedor se asigna un\nnúmero de control y un número de comprobante, y se devuelve el enlace al PDF.\n\nDocumentación: {{host}}doc/endpoints/retencion-islr.html",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"data\": [\n    {\n      \"cliente\": [\n        {\n          \"documentoIdentidadCliente\": \"J123456789\",\n          \"nombreRazonSocialCliente\": \"Cliente Ejemplo C.A.\",\n          \"correoCliente\": \"proveedor@example.com\",\n          \"direccionCliente\": \"Av. Principal, Caracas\",\n          \"telefonoCliente\": \"04141234567\"\n        }\n      ],\n      \"retencionIslr\": [\n        {\n          \"numeroDocumento\": \"000456\",\n          \"numeroControl\": \"00-0000456\",\n          \"fecha\": \"2026-07-10\",\n          \"codigo\": \"004\",\n          \"conceptoPago\": \"Honorarios profesionales\",\n          \"codigoRetencionIslr\": \"004\",\n          \"porcentaje\": \"5%\",\n          \"montoDocumento\": \"10.000,00\",\n          \"baseRetencion\": \"10.000,00\",\n          \"montoRetenido\": \"500,00\"\n        }\n      ]\n    }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Consultar retenciones de IVA",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{host}}api/Invoice/get_retention_iva",
              "host": [
                "{{host}}"
              ],
              "path": [
                "api",
                "Invoice",
                "get_retention_iva"
              ]
            },
            "description": "Devuelve todos los comprobantes de retención de IVA emitidos o anulados por el negocio del token,\ncon su número de comprobante, número de control, estado y enlace al PDF.\n\nDocumentación: {{host}}doc/endpoints/consultar-retencion-iva.html"
          }
        },
        {
          "name": "Consultar retenciones de ISLR",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{host}}api/Invoice/get_retention_islr",
              "host": [
                "{{host}}"
              ],
              "path": [
                "api",
                "Invoice",
                "get_retention_islr"
              ]
            },
            "description": "Devuelve todos los comprobantes de retención de ISLR emitidos o anulados por el negocio del token,\ncon su número de comprobante, número de control, estado y enlace al PDF.\n\nDocumentación: {{host}}doc/endpoints/consultar-retencion-islr.html"
          }
        },
        {
          "name": "Códigos de concepto ISLR",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{host}}api/Invoice/islr_retention_codes",
              "host": [
                "{{host}}"
              ],
              "path": [
                "api",
                "Invoice",
                "islr_retention_codes"
              ]
            },
            "description": "Devuelve el catálogo de códigos de concepto de retención de ISLR con su descripción. Úsalo para\nllenar `codigoRetencionIslr` en [Retención de ISLR](/endpoints/retencion-islr).\n\nDocumentación: {{host}}doc/endpoints/codigos-islr.html"
          }
        },
        {
          "name": "Anular retención",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{host}}api/Invoice/cancel_retention",
              "host": [
                "{{host}}"
              ],
              "path": [
                "api",
                "Invoice",
                "cancel_retention"
              ]
            },
            "description": "Anula un comprobante de retención de IVA o de ISLR emitido por el negocio del token. La anulación\nmarca el comprobante completo (todas sus líneas) como `Anulada` y devuelve el enlace al PDF anulado.\n\nDocumentación: {{host}}doc/endpoints/anular-retencion.html",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"numero_comprobante\": \"20260700000012\",\n  \"numero_control\": \"00-00000070\",\n  \"tipo_documento\": \"IVA\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        }
      ]
    },
    {
      "name": "Operaciones",
      "item": [
        {
          "name": "Enviar documento fiscal",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{host}}api/Invoice/send_document",
              "host": [
                "{{host}}"
              ],
              "path": [
                "api",
                "Invoice",
                "send_document"
              ]
            },
            "description": "Envía por correo electrónico un documento fiscal ya emitido por el negocio del token (factura, nota de crédito o débito, orden de entrega, guía de despacho o comprobante de retención). Por defecto se envía al correo registrado del cliente; puedes indicar otro destinatario. Devuelve el correo al que se envió.\n\nDocumentación: {{host}}doc/endpoints/enviar-documento.html",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"tipo_documento\": \"factura\",\n  \"numero_documento\": \"00000123\",\n  \"numero_control\": \"00-00000456\",\n  \"correo\": \"cliente@example.com\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Anular factura",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{host}}api/Invoice/cancel_invoice",
              "host": [
                "{{host}}"
              ],
              "path": [
                "api",
                "Invoice",
                "cancel_invoice"
              ]
            },
            "description": "Anula una factura emitida por el negocio del token. Solo aplica a **facturas** (no a notas, órdenes, guías ni retenciones) que estén activas y **no pagadas**. Devuelve los datos de la factura anulada y sus enlaces de consulta y PDF.\n\nDocumentación: {{host}}doc/endpoints/anular-factura.html",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"numero_documento\": \"00000123\",\n  \"numero_control\": \"00-00000456\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        }
      ]
    }
  ]
}