{
  "info": {
    "name": "Faktura API v1",
    "description": "Facturación electrónica SUNAT con un JSON simple. Documentación: https://faktura-doc.cgallardo.me/",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://faktura-test.cgallardo.me"
    },
    {
      "key": "apiKey",
      "value": "sk_test_..."
    },
    {
      "key": "documentId",
      "value": "",
      "description": "id que devuelve la API al emitir"
    },
    {
      "key": "webhookId",
      "value": "",
      "description": "id que devuelve la API al registrar un webhook"
    }
  ],
  "item": [
    {
      "name": "Inicio",
      "item": [
        {
          "name": "Faktura API — Documentación para integradores",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{apiKey}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "description": "Ejemplo: pos-0042-000187"
              }
            ],
            "url": "{{baseUrl}}/v1/receipts",
            "body": {
              "mode": "raw",
              "raw": "{\"series\":\"B001\",\"customer\":{\"doc_type\":\"NONE\"},\"items\":[{\"description\":\"Café americano\",\"quantity\":2,\"unit_price\":8.00}]}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        }
      ]
    },
    {
      "name": "Guía: tu primera boleta en 10 minutos",
      "item": [
        {
          "name": "1. Verifica tu clave",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{apiKey}}"
              }
            ],
            "url": "{{baseUrl}}/v1/me"
          }
        },
        {
          "name": "2. Mira tus series",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{apiKey}}"
              }
            ],
            "url": "{{baseUrl}}/v1/series"
          }
        },
        {
          "name": "3. Emite la boleta",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{apiKey}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "description": "Ejemplo: mi-primera-boleta-001"
              }
            ],
            "url": "{{baseUrl}}/v1/receipts",
            "body": {
              "mode": "raw",
              "raw": "{\n    \"series\": \"B001\",\n    \"customer\": { \"doc_type\": \"NONE\" },\n    \"items\": [ { \"description\": \"Café americano\", \"quantity\": 2, \"unit_price\": 8.00 } ]\n  }",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "4. Espera la respuesta de SUNAT",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{apiKey}}"
              }
            ],
            "url": "{{baseUrl}}/v1/documents/{{documentId}}"
          }
        },
        {
          "name": "5. Descarga el XML y el CDR (1)",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{apiKey}}"
              }
            ],
            "url": "{{baseUrl}}/v1/documents/{{documentId}}/xml"
          }
        },
        {
          "name": "5. Descarga el XML y el CDR (2)",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{apiKey}}"
              }
            ],
            "url": "{{baseUrl}}/v1/documents/{{documentId}}/cdr"
          }
        }
      ]
    },
    {
      "name": "Emitir una factura",
      "item": [
        {
          "name": "Ejemplo: factura al contado",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{apiKey}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "description": "Ejemplo: erp-pedido-8841"
              }
            ],
            "url": "{{baseUrl}}/v1/invoices",
            "body": {
              "mode": "raw",
              "raw": "{\n    \"series\": \"F001\",\n    \"customer\": { \"doc_type\": \"RUC\", \"doc_number\": \"20100070970\", \"name\": \"CLIENTE S.A.C.\" },\n    \"items\": [\n      { \"description\": \"Laptop\", \"quantity\": 1, \"unit_price\": 118 },\n      { \"description\": \"Libro\", \"quantity\": 2, \"unit_price\": 5.5, \"igv_type\": \"exonerado\" }\n    ]\n  }",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        }
      ]
    },
    {
      "name": "Ejemplos de facturas",
      "item": [
        {
          "name": "Factura en dólares",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{apiKey}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "description": "Ejemplo: erp-pedido-9001"
              }
            ],
            "url": "{{baseUrl}}/v1/invoices",
            "body": {
              "mode": "raw",
              "raw": "{\n    \"series\": \"F001\",\n    \"currency\": \"USD\",\n    \"customer\": { \"doc_type\": \"RUC\", \"doc_number\": \"20100070970\", \"name\": \"CLIENTE S.A.C.\" },\n    \"items\": [ { \"description\": \"Licencia de software (anual)\", \"quantity\": 1, \"unit_price\": 590 } ]\n  }",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Precios sin IGV",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{apiKey}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "description": "Ejemplo: erp-pedido-9002"
              }
            ],
            "url": "{{baseUrl}}/v1/invoices",
            "body": {
              "mode": "raw",
              "raw": "{\n    \"series\": \"F001\",\n    \"price_includes_tax\": false,\n    \"customer\": { \"doc_type\": \"RUC\", \"doc_number\": \"20100070970\", \"name\": \"CLIENTE S.A.C.\" },\n    \"items\": [ { \"description\": \"Servicio de consultoría\", \"quantity\": 10, \"unit_price\": 100, \"unit_code\": \"HUR\" } ]\n  }",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Ítems gravados, exonerados e inafectos en la misma factura",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{apiKey}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "description": "Ejemplo: erp-pedido-9003"
              }
            ],
            "url": "{{baseUrl}}/v1/invoices",
            "body": {
              "mode": "raw",
              "raw": "{\n    \"series\": \"F001\",\n    \"customer\": { \"doc_type\": \"RUC\", \"doc_number\": \"20100070970\", \"name\": \"CLIENTE S.A.C.\" },\n    \"items\": [\n      { \"description\": \"Laptop\", \"quantity\": 1, \"unit_price\": 118 },\n      { \"description\": \"Libro\", \"quantity\": 2, \"unit_price\": 30, \"igv_type\": \"exonerado\" },\n      { \"description\": \"Producto inafecto\", \"quantity\": 1, \"unit_price\": 50, \"igv_type\": \"inafecto\" }\n    ]\n  }",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Entregas gratuitas (muestras o regalos)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{apiKey}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "description": "Ejemplo: erp-pedido-9004"
              }
            ],
            "url": "{{baseUrl}}/v1/invoices",
            "body": {
              "mode": "raw",
              "raw": "{\n    \"series\": \"F001\",\n    \"customer\": { \"doc_type\": \"RUC\", \"doc_number\": \"20100070970\", \"name\": \"CLIENTE S.A.C.\" },\n    \"items\": [\n      { \"description\": \"Caja de café 1 kg\", \"quantity\": 5, \"unit_price\": 59 },\n      { \"description\": \"Taza de regalo\", \"quantity\": 1, \"unit_price\": 23.60, \"igv_type\": \"gratuito\" }\n    ]\n  }",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Con orden de compra, guía de remisión y vencimiento",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{apiKey}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "description": "Ejemplo: erp-pedido-9005"
              }
            ],
            "url": "{{baseUrl}}/v1/invoices",
            "body": {
              "mode": "raw",
              "raw": "{\n    \"series\": \"F001\",\n    \"customer\": { \"doc_type\": \"RUC\", \"doc_number\": \"20100070970\", \"name\": \"CLIENTE S.A.C.\", \"address\": \"AV. LOS OLIVOS 123, LIMA\" },\n    \"items\": [ { \"description\": \"Cemento Portland tipo I (bolsa 42.5 kg)\", \"quantity\": 100, \"unit_price\": 29.50, \"unit_code\": \"BG\" } ],\n    \"purchase_order\": \"OC-2026-001\",\n    \"despatch_references\": [ { \"type\": \"09\", \"number\": \"T001-123\" } ],\n    \"observations\": \"Entrega en almacén central\",\n    \"due_date\": \"2026-12-15\"\n  }",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Con fecha de emisión anterior (contingencia)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{apiKey}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "description": "Ejemplo: erp-pedido-9006"
              }
            ],
            "url": "{{baseUrl}}/v1/invoices",
            "body": {
              "mode": "raw",
              "raw": "{\n    \"series\": \"F001\",\n    \"issue_date\": \"2026-11-11\",\n    \"customer\": { \"doc_type\": \"RUC\", \"doc_number\": \"20100070970\", \"name\": \"CLIENTE S.A.C.\" },\n    \"items\": [ { \"description\": \"Laptop\", \"quantity\": 1, \"unit_price\": 118 } ]\n  }",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        }
      ]
    },
    {
      "name": "Guía: factura al crédito con cuotas",
      "item": [
        {
          "name": "Ejemplo: consultoría en dólares, a 2 cuotas",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{apiKey}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "description": "Ejemplo: erp-pedido-8842"
              }
            ],
            "url": "{{baseUrl}}/v1/invoices",
            "body": {
              "mode": "raw",
              "raw": "{\n    \"series\": \"F001\",\n    \"currency\": \"USD\",\n    \"price_includes_tax\": false,\n    \"customer\": { \"doc_type\": \"RUC\", \"doc_number\": \"20131312955\", \"name\": \"CLIENTE DE PRUEBA S.A.C.\" },\n    \"items\": [ { \"description\": \"Consultoría\", \"quantity\": 3, \"unit_price\": 10.555, \"unit_code\": \"HUR\" } ],\n    \"payment\": {\n      \"type\": \"credito\",\n      \"installments\": [\n        { \"amount\": 20.00, \"due_date\": \"2026-12-15\" },\n        { \"amount\": 17.37, \"due_date\": \"2027-01-15\" }\n      ]\n    }\n  }",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        }
      ]
    },
    {
      "name": "Descuentos, detracción y retención",
      "item": [
        {
          "name": "Descuento por ítem y descuento global",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{apiKey}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "description": "Ejemplo: erp-pedido-9101"
              }
            ],
            "url": "{{baseUrl}}/v1/invoices",
            "body": {
              "mode": "raw",
              "raw": "{\n    \"series\": \"F001\",\n    \"customer\": { \"doc_type\": \"RUC\", \"doc_number\": \"20100070970\", \"name\": \"CLIENTE S.A.C.\" },\n    \"items\": [\n      { \"description\": \"Laptop\", \"quantity\": 1, \"unit_price\": 118, \"discount\": { \"amount\": 18 } },\n      { \"description\": \"Mouse\", \"quantity\": 2, \"unit_price\": 50, \"discount\": { \"percent\": 10 } },\n      { \"description\": \"Libro\", \"quantity\": 1, \"unit_price\": 20, \"igv_type\": \"exonerado\" }\n    ],\n    \"discount\": { \"amount\": 11.8 }\n  }",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Detracción (SPOT)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{apiKey}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "description": "Ejemplo: erp-pedido-9102"
              }
            ],
            "url": "{{baseUrl}}/v1/invoices",
            "body": {
              "mode": "raw",
              "raw": "{\n    \"series\": \"F001\",\n    \"customer\": { \"doc_type\": \"RUC\", \"doc_number\": \"20100070970\", \"name\": \"CLIENTE S.A.C.\" },\n    \"items\": [{ \"description\": \"Mantenimiento de equipos\", \"quantity\": 1, \"unit_price\": 1180 }],\n    \"detraction\": { \"code\": \"020\", \"percent\": 12, \"bank_account\": \"00-000-123456\" },\n    \"payment\": { \"type\": \"credito\", \"installments\": [{ \"amount\": 1038.40, \"due_date\": \"2026-12-15\" }] }\n  }",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Retención del IGV",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{apiKey}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "description": "Ejemplo: erp-pedido-9103"
              }
            ],
            "url": "{{baseUrl}}/v1/invoices",
            "body": {
              "mode": "raw",
              "raw": "{\n    \"series\": \"F001\",\n    \"customer\": { \"doc_type\": \"RUC\", \"doc_number\": \"20100070970\", \"name\": \"CLIENTE S.A.C.\" },\n    \"items\": [{ \"description\": \"Repuestos\", \"quantity\": 1, \"unit_price\": 1180 }],\n    \"retention\": true,\n    \"payment\": { \"type\": \"credito\", \"installments\": [{ \"amount\": 1144.60, \"due_date\": \"2026-12-15\" }] }\n  }",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        }
      ]
    },
    {
      "name": "Emitir una boleta",
      "item": [
        {
          "name": "Emitir una boleta",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{apiKey}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "description": "Ejemplo: pos-0042-000187"
              }
            ],
            "url": "{{baseUrl}}/v1/receipts",
            "body": {
              "mode": "raw",
              "raw": "{\n    \"series\": \"B001\",\n    \"customer\": { \"doc_type\": \"DNI\", \"doc_number\": \"45678912\", \"name\": \"MARIA PEREZ\" },\n    \"items\": [\n      { \"product_code\": \"CAF-01\", \"description\": \"Cafe americano\", \"quantity\": 2, \"unit_price\": 8.00 },\n      { \"description\": \"Bolsa plastica\", \"quantity\": 1, \"unit_price\": 0.10, \"icbper\": true }\n    ]\n  }",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        }
      ]
    },
    {
      "name": "Ejemplos de boletas",
      "item": [
        {
          "name": "Venta de más de S/ 700: cliente identificado",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{apiKey}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "description": "Ejemplo: pos-0042-000301"
              }
            ],
            "url": "{{baseUrl}}/v1/receipts",
            "body": {
              "mode": "raw",
              "raw": "{\n    \"series\": \"B001\",\n    \"customer\": { \"doc_type\": \"DNI\", \"doc_number\": \"45678912\", \"name\": \"MARIA PEREZ\" },\n    \"items\": [ { \"description\": \"Refrigeradora 300 L\", \"quantity\": 1, \"unit_price\": 1899 } ]\n  }",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Restaurante: recargo al consumo",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{apiKey}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "description": "Ejemplo: pos-0042-000302"
              }
            ],
            "url": "{{baseUrl}}/v1/receipts",
            "body": {
              "mode": "raw",
              "raw": "{\n    \"series\": \"B001\",\n    \"customer\": { \"doc_type\": \"NONE\" },\n    \"items\": [\n      { \"description\": \"Lomo saltado\", \"quantity\": 2, \"unit_price\": 38 },\n      { \"description\": \"Chicha morada (jarra)\", \"quantity\": 1, \"unit_price\": 18 }\n    ],\n    \"service_charge\": { \"percent\": 10 }\n  }",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Boleta en dólares",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{apiKey}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "description": "Ejemplo: pos-0042-000303"
              }
            ],
            "url": "{{baseUrl}}/v1/receipts",
            "body": {
              "mode": "raw",
              "raw": "{\n    \"series\": \"B001\",\n    \"currency\": \"USD\",\n    \"customer\": { \"doc_type\": \"PASAPORTE\", \"doc_number\": \"X1234567\", \"name\": \"JOHN SMITH\" },\n    \"items\": [ { \"description\": \"Tour Valle Sagrado\", \"quantity\": 2, \"unit_price\": 45 } ]\n  }",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        }
      ]
    },
    {
      "name": "Emitir una nota de crédito",
      "item": [
        {
          "name": "Ejemplo: anular una factura con nota de crédito",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{apiKey}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": "{{baseUrl}}/v1/credit-notes",
            "body": {
              "mode": "raw",
              "raw": "{\n    \"affected_document_id\": \"{{documentId}}\",\n    \"series\": \"FC01\",\n    \"reason_code\": \"01\"\n  }",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        }
      ]
    },
    {
      "name": "Emitir una nota de débito",
      "item": [
        {
          "name": "Ejemplo: nota de débito por intereses",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{apiKey}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": "{{baseUrl}}/v1/debit-notes",
            "body": {
              "mode": "raw",
              "raw": "{\n    \"affected_document_id\": \"{{documentId}}\",\n    \"series\": \"FD01\",\n    \"reason_code\": \"01\",\n    \"items\": [ { \"description\": \"Intereses por mora\", \"quantity\": 1, \"unit_price\": 11.80 } ]\n  }",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        }
      ]
    },
    {
      "name": "Ejemplos de notas y anulaciones",
      "item": [
        {
          "name": "Devolver parte de una factura",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{apiKey}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "description": "Ejemplo: erp-devolucion-0001"
              }
            ],
            "url": "{{baseUrl}}/v1/credit-notes",
            "body": {
              "mode": "raw",
              "raw": "{\n    \"affected_document_id\": \"{{documentId}}\",\n    \"series\": \"FC01\",\n    \"reason_code\": \"07\",\n    \"reason_description\": \"Devolución de 2 libros\",\n    \"items\": [ { \"description\": \"Libro\", \"quantity\": 2, \"unit_price\": 5.5, \"igv_type\": \"exonerado\" } ]\n  }",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Descuento después de emitir",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{apiKey}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "description": "Ejemplo: erp-descuento-0001"
              }
            ],
            "url": "{{baseUrl}}/v1/credit-notes",
            "body": {
              "mode": "raw",
              "raw": "{\n    \"affected_document_id\": \"{{documentId}}\",\n    \"series\": \"FC01\",\n    \"reason_code\": \"04\",\n    \"reason_description\": \"Descuento por pronto pago\",\n    \"items\": [ { \"description\": \"Descuento por pronto pago\", \"quantity\": 1, \"unit_price\": 11.80 } ]\n  }",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Nota de crédito a una boleta",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{apiKey}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "description": "Ejemplo: pos-0042-devolucion-01"
              }
            ],
            "url": "{{baseUrl}}/v1/credit-notes",
            "body": {
              "mode": "raw",
              "raw": "{\n    \"affected_document_id\": \"{{documentId}}\",\n    \"series\": \"BC01\",\n    \"reason_code\": \"07\",\n    \"items\": [ { \"description\": \"Cafe americano\", \"quantity\": 1, \"unit_price\": 8.00 } ]\n  }",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Nota de débito por penalidad",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{apiKey}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "description": "Ejemplo: erp-penalidad-0001"
              }
            ],
            "url": "{{baseUrl}}/v1/debit-notes",
            "body": {
              "mode": "raw",
              "raw": "{\n    \"affected_document_id\": \"{{documentId}}\",\n    \"series\": \"FD01\",\n    \"reason_code\": \"03\",\n    \"reason_description\": \"Penalidad por entrega tardía\",\n    \"items\": [ { \"description\": \"Penalidad por entrega tardía\", \"quantity\": 1, \"unit_price\": 59 } ]\n  }",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Anular una boleta",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{apiKey}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": "{{baseUrl}}/v1/documents/{{documentId}}/void",
            "body": {
              "mode": "raw",
              "raw": "{ \"reason\": \"Venta duplicada\" }",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        }
      ]
    },
    {
      "name": "Listar comprobantes",
      "item": [
        {
          "name": "Listar comprobantes",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{apiKey}}"
              }
            ],
            "url": "{{baseUrl}}/v1/documents?document_type=03&from=2026-11-01&to=2026-11-30&page=1&page_size=50"
          }
        },
        {
          "name": "Buscar por serie y correlativo",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{apiKey}}"
              }
            ],
            "url": "{{baseUrl}}/v1/documents?series=B001&number=1"
          }
        }
      ]
    },
    {
      "name": "Ver un comprobante",
      "item": [
        {
          "name": "Ver un comprobante",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{apiKey}}"
              }
            ],
            "url": "{{baseUrl}}/v1/documents/{{documentId}}"
          }
        }
      ]
    },
    {
      "name": "Representación impresa (PDF)",
      "item": [
        {
          "name": "Formato A4",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{apiKey}}"
              }
            ],
            "url": "{{baseUrl}}/v1/documents/{{documentId}}/pdf?format=a4"
          }
        },
        {
          "name": "Formato ticket (80 mm)",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{apiKey}}"
              }
            ],
            "url": "{{baseUrl}}/v1/documents/{{documentId}}/pdf?format=ticket"
          }
        }
      ]
    },
    {
      "name": "Descargar el XML firmado",
      "item": [
        {
          "name": "Descargar el XML firmado",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{apiKey}}"
              }
            ],
            "url": "{{baseUrl}}/v1/documents/{{documentId}}/xml"
          }
        }
      ]
    },
    {
      "name": "Descargar el CDR",
      "item": [
        {
          "name": "Descargar el CDR",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{apiKey}}"
              }
            ],
            "url": "{{baseUrl}}/v1/documents/{{documentId}}/cdr"
          }
        }
      ]
    },
    {
      "name": "Enviar el comprobante por correo",
      "item": [
        {
          "name": "Enviar el comprobante por correo",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{apiKey}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": "{{baseUrl}}/v1/documents/{{documentId}}/email",
            "body": {
              "mode": "raw",
              "raw": "{ \"to\": [\"cliente@ejemplo.pe\"] }",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        }
      ]
    },
    {
      "name": "Reenviar un comprobante que falló",
      "item": [
        {
          "name": "Reenviar un comprobante que falló",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{apiKey}}"
              }
            ],
            "url": "{{baseUrl}}/v1/documents/{{documentId}}/retry"
          }
        }
      ]
    },
    {
      "name": "Anular un comprobante",
      "item": [
        {
          "name": "Anular un comprobante",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{apiKey}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": "{{baseUrl}}/v1/documents/{{documentId}}/void",
            "body": {
              "mode": "raw",
              "raw": "{ \"reason\": \"Error en el precio\" }",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        }
      ]
    },
    {
      "name": "Consultar un RUC",
      "item": [
        {
          "name": "Consultar un RUC",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{apiKey}}"
              }
            ],
            "url": "{{baseUrl}}/v1/lookup/ruc/20131312955"
          }
        }
      ]
    },
    {
      "name": "Consultar varios RUC a la vez",
      "item": [
        {
          "name": "Consultar varios RUC a la vez",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{apiKey}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": "{{baseUrl}}/v1/lookup/ruc",
            "body": {
              "mode": "raw",
              "raw": "{ \"rucs\": [\"20131312955\", \"10467793549\", \"20600000005\", \"123\"] }",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        }
      ]
    },
    {
      "name": "Consultar un DNI",
      "item": [
        {
          "name": "Consultar un DNI",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{apiKey}}"
              }
            ],
            "url": "{{baseUrl}}/v1/lookup/dni/46779354"
          }
        }
      ]
    },
    {
      "name": "Registrar un webhook",
      "item": [
        {
          "name": "Registrar un webhook",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{apiKey}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": "{{baseUrl}}/v1/webhooks",
            "body": {
              "mode": "raw",
              "raw": "{ \"url\": \"https://erp.miempresa.pe/faktura/webhook\", \"events\": [\"document.accepted\", \"document.rejected\"] }",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        }
      ]
    },
    {
      "name": "Listar webhooks",
      "item": [
        {
          "name": "Listar webhooks",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{apiKey}}"
              }
            ],
            "url": "{{baseUrl}}/v1/webhooks"
          }
        }
      ]
    },
    {
      "name": "Eliminar un webhook",
      "item": [
        {
          "name": "Eliminar un webhook",
          "request": {
            "method": "DELETE",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{apiKey}}"
              }
            ],
            "url": "{{baseUrl}}/v1/webhooks/{{webhookId}}"
          }
        }
      ]
    },
    {
      "name": "Verificar la API key",
      "item": [
        {
          "name": "Verificar la API key",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{apiKey}}"
              }
            ],
            "url": "{{baseUrl}}/v1/me"
          }
        }
      ]
    },
    {
      "name": "Series",
      "item": [
        {
          "name": "Series",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{apiKey}}"
              }
            ],
            "url": "{{baseUrl}}/v1/series"
          }
        }
      ]
    }
  ]
}
