{
    "info": {
        "_postman_id": "f00feaf5-c2d7-48b2-8a41-62442b04ab65",
        "name": "Sistema Facturación Perú · API v1",
        "description": "API REST de cada empresa en `https://<tu-subdominio>.sistemafacturacionperu.com/api/v1`.\nModo pruebas (beta de SUNAT, empresa aparte, se borra a los 7 días): `https://pruebas.sistemafacturacionperu.com/api/v1`.\n\n- Autenticación: `Authorization: Bearer sfp_live_…` (o `sfp_test_…` en pruebas). Nunca en la URL (401 `clave_en_url`).\n- Éxito: `{ \"success\": true, \"data\": …, \"meta\"?: … }`. Error: `{ \"success\": false, \"code\": \"…\", \"message\": \"…\", \"errors\"?: {…} }`.\n- Todo `POST` acepta `Idempotency-Key` (recomendado): el reintento con el mismo cuerpo devuelve la misma respuesta\n  con `Idempotent-Replayed: true`.\n- Límites: 120 llamadas por minuto por clave y 30 emisiones por minuto (cabeceras `X-RateLimit-Limit` y\n  `X-RateLimit-Remaining`; al pasarte, 429 con `Retry-After`).\n- La API viene desde el Plan PRO (403 `plan_sin_api`).\n\nGuía completa: https://sistemafacturacionperu.com/desarrolladores/",
        "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json",
        "version": "1.0.0"
    },
    "auth": {
        "type": "bearer",
        "bearer": [
            {
                "key": "token",
                "value": "{{api_key}}",
                "type": "string"
            }
        ]
    },
    "variable": [
        {
            "key": "base_url",
            "value": "https://pruebas.sistemafacturacionperu.com/api/v1",
            "type": "string",
            "description": "Modo pruebas. En producción: https://<tu-subdominio>.sistemafacturacionperu.com/api/v1"
        },
        {
            "key": "api_key",
            "value": "sfp_test_TU_CLAVE",
            "type": "string",
            "description": "Tu clave sfp_test_ (pruebas) o sfp_live_ (producción). Configuración › Sistema › Integraciones › API"
        }
    ],
    "item": [
        {
            "name": "Cuenta",
            "item": [
                {
                    "name": "Con qué clave, usuario, local y permisos estás llamando",
                    "request": {
                        "method": "GET",
                        "header": [],
                        "url": {
                            "raw": "{{base_url}}/yo",
                            "host": [
                                "{{base_url}}"
                            ],
                            "path": [
                                "yo"
                            ]
                        }
                    }
                }
            ]
        },
        {
            "name": "Comprobantes",
            "description": "Factura (01), boleta (03), nota de crédito (07) y de débito (08).",
            "item": [
                {
                    "name": "Listar comprobantes (paginado)",
                    "request": {
                        "method": "GET",
                        "header": [],
                        "url": {
                            "raw": "{{base_url}}/comprobantes",
                            "host": [
                                "{{base_url}}"
                            ],
                            "path": [
                                "comprobantes"
                            ],
                            "query": [
                                {
                                    "key": "desde",
                                    "disabled": true
                                },
                                {
                                    "key": "hasta",
                                    "disabled": true
                                },
                                {
                                    "key": "tipo",
                                    "value": "01",
                                    "disabled": true
                                },
                                {
                                    "key": "serie",
                                    "disabled": true
                                },
                                {
                                    "key": "numero",
                                    "disabled": true
                                },
                                {
                                    "key": "estado",
                                    "description": "Clave (registrado, enviado, aceptado, observado, rechazado, anulado, por_anular) o código SUNAT",
                                    "disabled": true
                                },
                                {
                                    "key": "cliente_numero",
                                    "description": "RUC o DNI del cliente",
                                    "disabled": true
                                },
                                {
                                    "key": "page",
                                    "value": "1",
                                    "disabled": true
                                },
                                {
                                    "key": "per_page",
                                    "value": "20",
                                    "disabled": true
                                }
                            ]
                        },
                        "description": "Un usuario que no ve toda la empresa (por ejemplo, un vendedor) ve solo los suyos. Alcance `comprobantes.leer`."
                    }
                },
                {
                    "name": "Emitir factura, boleta, nota de crédito o de débito",
                    "request": {
                        "method": "POST",
                        "header": [
                            {
                                "key": "Content-Type",
                                "value": "application/json"
                            },
                            {
                                "key": "Idempotency-Key",
                                "value": "{{$guid}}",
                                "description": "Única por operación: un reintento con la misma clave no emite dos veces."
                            }
                        ],
                        "url": {
                            "raw": "{{base_url}}/comprobantes",
                            "host": [
                                "{{base_url}}"
                            ],
                            "path": [
                                "comprobantes"
                            ]
                        },
                        "body": {
                            "mode": "raw",
                            "raw": "{\n    \"serie_documento\": \"B001\",\n    \"numero_documento\": \"#\",\n    \"fecha_de_emision\": \"2026-11-03\",\n    \"hora_de_emision\": \"10:15:00\",\n    \"codigo_tipo_operacion\": \"0101\",\n    \"codigo_tipo_documento\": \"03\",\n    \"codigo_tipo_moneda\": \"PEN\",\n    \"establecimiento\": \"0000\",\n    \"datos_del_cliente_o_receptor\": {\n        \"codigo_tipo_documento_identidad\": \"1\",\n        \"numero_documento\": \"70123456\",\n        \"apellidos_y_nombres_o_razon_social\": \"Ana Pérez\",\n        \"codigo_pais\": \"PE\"\n    },\n    \"totales\": {\n        \"total_operaciones_gravadas\": 50.85,\n        \"total_igv\": 9.15,\n        \"total_impuestos\": 9.15,\n        \"total_valor\": 50.85,\n        \"total_venta\": 60\n    },\n    \"items\": [\n        {\n            \"codigo_interno\": \"POLO-01\",\n            \"descripcion\": \"Polo azul talla M\",\n            \"unidad_de_medida\": \"NIU\",\n            \"cantidad\": 2,\n            \"valor_unitario\": 25.42,\n            \"codigo_tipo_precio\": \"01\",\n            \"precio_unitario\": 30,\n            \"codigo_tipo_afectacion_igv\": \"10\",\n            \"total_base_igv\": 50.85,\n            \"porcentaje_igv\": 18,\n            \"total_igv\": 9.15,\n            \"total_impuestos\": 9.15,\n            \"total_valor_item\": 50.85,\n            \"total_item\": 60\n        }\n    ],\n    \"pagos\": [\n        {\n            \"codigo_metodo_pago\": \"01\",\n            \"codigo_destino_pago\": \"cash\",\n            \"monto\": 60\n        }\n    ]\n}",
                            "options": {
                                "raw": {
                                    "language": "json"
                                }
                            }
                        },
                        "description": "El mismo JSON de `POST /api/documents` de la API antigua, más `establecimiento`, `origen` y, en cada línea,\n`almacen_id`, `series` y `lotes` por código. Se envía a SUNAT según la configuración de la empresa (las boletas van\nen el resumen diario). Alcance `comprobantes.emitir`; función `sales.documents.create`."
                    }
                },
                {
                    "name": "Buscar por serie y número",
                    "request": {
                        "method": "GET",
                        "header": [],
                        "url": {
                            "raw": "{{base_url}}/comprobantes/buscar?serie=F001&numero=120",
                            "host": [
                                "{{base_url}}"
                            ],
                            "path": [
                                "comprobantes",
                                "buscar"
                            ],
                            "query": [
                                {
                                    "key": "serie",
                                    "value": "F001"
                                },
                                {
                                    "key": "numero",
                                    "value": "120"
                                },
                                {
                                    "key": "tipo",
                                    "value": "01",
                                    "disabled": true
                                }
                            ]
                        }
                    }
                },
                {
                    "name": "Consultar un comprobante (por id o external_id)",
                    "request": {
                        "method": "GET",
                        "header": [],
                        "url": {
                            "raw": "{{base_url}}/comprobantes/:id",
                            "host": [
                                "{{base_url}}"
                            ],
                            "path": [
                                "comprobantes",
                                ":id"
                            ],
                            "variable": [
                                {
                                    "key": "id",
                                    "description": "Id numérico o external_id (UUID)"
                                }
                            ]
                        }
                    }
                },
                {
                    "name": "Descargar el PDF",
                    "request": {
                        "method": "GET",
                        "header": [],
                        "url": {
                            "raw": "{{base_url}}/comprobantes/:id/pdf",
                            "host": [
                                "{{base_url}}"
                            ],
                            "path": [
                                "comprobantes",
                                ":id",
                                "pdf"
                            ],
                            "query": [
                                {
                                    "key": "formato",
                                    "value": "a4",
                                    "disabled": true
                                }
                            ],
                            "variable": [
                                {
                                    "key": "id",
                                    "description": "Id numérico o external_id (UUID)"
                                }
                            ]
                        },
                        "description": "Alcance `comprobantes.leer`; función `sales.documents.export`."
                    }
                },
                {
                    "name": "Descargar el XML firmado",
                    "request": {
                        "method": "GET",
                        "header": [],
                        "url": {
                            "raw": "{{base_url}}/comprobantes/:id/xml",
                            "host": [
                                "{{base_url}}"
                            ],
                            "path": [
                                "comprobantes",
                                ":id",
                                "xml"
                            ],
                            "variable": [
                                {
                                    "key": "id",
                                    "description": "Id numérico o external_id (UUID)"
                                }
                            ]
                        }
                    }
                },
                {
                    "name": "Descargar la constancia de SUNAT (CDR, zip)",
                    "request": {
                        "method": "GET",
                        "header": [],
                        "url": {
                            "raw": "{{base_url}}/comprobantes/:id/cdr",
                            "host": [
                                "{{base_url}}"
                            ],
                            "path": [
                                "comprobantes",
                                ":id",
                                "cdr"
                            ],
                            "variable": [
                                {
                                    "key": "id",
                                    "description": "Id numérico o external_id (UUID)"
                                }
                            ]
                        }
                    }
                },
                {
                    "name": "Reenviar una factura (o su nota) registrada a SUNAT",
                    "request": {
                        "method": "POST",
                        "header": [
                            {
                                "key": "Idempotency-Key",
                                "value": "{{$guid}}",
                                "description": "Única por operación: un reintento con la misma clave no emite dos veces."
                            }
                        ],
                        "url": {
                            "raw": "{{base_url}}/comprobantes/:id/reenviar-sunat",
                            "host": [
                                "{{base_url}}"
                            ],
                            "path": [
                                "comprobantes",
                                ":id",
                                "reenviar-sunat"
                            ],
                            "variable": [
                                {
                                    "key": "id",
                                    "description": "Id numérico o external_id (UUID)"
                                }
                            ]
                        },
                        "description": "Las boletas van en el resumen diario (422 `va_en_resumen`). Función `sales.sunat_status.manage`."
                    }
                },
                {
                    "name": "Enviar por correo o por el WhatsApp de tu empresa",
                    "request": {
                        "method": "POST",
                        "header": [
                            {
                                "key": "Content-Type",
                                "value": "application/json"
                            },
                            {
                                "key": "Idempotency-Key",
                                "value": "{{$guid}}",
                                "description": "Única por operación: un reintento con la misma clave no emite dos veces."
                            }
                        ],
                        "url": {
                            "raw": "{{base_url}}/comprobantes/:id/enviar",
                            "host": [
                                "{{base_url}}"
                            ],
                            "path": [
                                "comprobantes",
                                ":id",
                                "enviar"
                            ],
                            "variable": [
                                {
                                    "key": "id",
                                    "description": "Id numérico o external_id (UUID)"
                                }
                            ]
                        },
                        "body": {
                            "mode": "raw",
                            "raw": "{\n    \"canal\": \"correo\",\n    \"destino\": \"compras@cliente.pe\"\n}",
                            "options": {
                                "raw": {
                                    "language": "json"
                                }
                            }
                        },
                        "description": "WhatsApp sale SOLO por la línea propia de tu empresa (Canales › WhatsApp), nunca por la de la plataforma."
                    }
                }
            ]
        },
        {
            "name": "Anulaciones",
            "item": [
                {
                    "name": "Anular (el sistema elige baja o resumen)",
                    "request": {
                        "method": "POST",
                        "header": [
                            {
                                "key": "Content-Type",
                                "value": "application/json"
                            },
                            {
                                "key": "Idempotency-Key",
                                "value": "{{$guid}}",
                                "description": "Única por operación: un reintento con la misma clave no emite dos veces."
                            }
                        ],
                        "url": {
                            "raw": "{{base_url}}/comprobantes/:id/anular",
                            "host": [
                                "{{base_url}}"
                            ],
                            "path": [
                                "comprobantes",
                                ":id",
                                "anular"
                            ],
                            "variable": [
                                {
                                    "key": "id",
                                    "description": "Id numérico o external_id (UUID)"
                                }
                            ]
                        },
                        "body": {
                            "mode": "raw",
                            "raw": "{\n    \"motivo\": \"Error en el precio\"\n}",
                            "options": {
                                "raw": {
                                    "language": "json"
                                }
                            }
                        },
                        "description": "Factura y sus notas → comunicación de baja; boleta y sus notas → resumen diario de anulación. Solo comprobantes\naceptados u observados. Devuelve el ticket de SUNAT. Alcance `comprobantes.anular`; función `sales.documents.void`."
                    }
                },
                {
                    "name": "Estado de una baja o resumen de anulación (consulta a SUNAT)",
                    "request": {
                        "method": "GET",
                        "header": [],
                        "url": {
                            "raw": "{{base_url}}/anulaciones/:ticket",
                            "host": [
                                "{{base_url}}"
                            ],
                            "path": [
                                "anulaciones",
                                ":ticket"
                            ],
                            "variable": [
                                {
                                    "key": "ticket"
                                }
                            ]
                        }
                    }
                }
            ]
        },
        {
            "name": "Cobros",
            "item": [
                {
                    "name": "Cobros y saldo pendiente",
                    "request": {
                        "method": "GET",
                        "header": [],
                        "url": {
                            "raw": "{{base_url}}/comprobantes/:id/cobros",
                            "host": [
                                "{{base_url}}"
                            ],
                            "path": [
                                "comprobantes",
                                ":id",
                                "cobros"
                            ],
                            "variable": [
                                {
                                    "key": "id",
                                    "description": "Id numérico o external_id (UUID)"
                                }
                            ]
                        }
                    }
                },
                {
                    "name": "Registrar un cobro",
                    "request": {
                        "method": "POST",
                        "header": [
                            {
                                "key": "Content-Type",
                                "value": "application/json"
                            },
                            {
                                "key": "Idempotency-Key",
                                "value": "{{$guid}}",
                                "description": "Única por operación: un reintento con la misma clave no emite dos veces."
                            }
                        ],
                        "url": {
                            "raw": "{{base_url}}/comprobantes/:id/cobros",
                            "host": [
                                "{{base_url}}"
                            ],
                            "path": [
                                "comprobantes",
                                ":id",
                                "cobros"
                            ],
                            "variable": [
                                {
                                    "key": "id",
                                    "description": "Id numérico o external_id (UUID)"
                                }
                            ]
                        },
                        "body": {
                            "mode": "raw",
                            "raw": "{\n    \"fecha\": \"2026-11-03\",\n    \"monto\": 590,\n    \"medio\": \"005\",\n    \"cuenta_cobro_id\": 2,\n    \"referencia\": \"OP-778812\"\n}",
                            "options": {
                                "raw": {
                                    "language": "json"
                                }
                            }
                        },
                        "description": "Por el mismo servicio de la web (Por cobrar › Registrar cobro): un medio que no es efectivo va a una cuenta de cobro\n(`cuenta_cobro_id`, banco o billetera del tipo del medio) y con N.° de operación. Alcance `cobros.registrar`;\nfunción `finance.payments.create`."
                    }
                }
            ]
        },
        {
            "name": "Guías",
            "description": "Guía de remisión remitente (09) y transportista (31).",
            "item": [
                {
                    "name": "Listar guías",
                    "request": {
                        "method": "GET",
                        "header": [],
                        "url": {
                            "raw": "{{base_url}}/guias",
                            "host": [
                                "{{base_url}}"
                            ],
                            "path": [
                                "guias"
                            ],
                            "query": [
                                {
                                    "key": "desde",
                                    "disabled": true
                                },
                                {
                                    "key": "hasta",
                                    "disabled": true
                                },
                                {
                                    "key": "tipo",
                                    "value": "09",
                                    "disabled": true
                                },
                                {
                                    "key": "serie",
                                    "disabled": true
                                },
                                {
                                    "key": "numero",
                                    "disabled": true
                                },
                                {
                                    "key": "estado",
                                    "description": "registrado, pendiente, aceptado, rechazado…",
                                    "disabled": true
                                },
                                {
                                    "key": "page",
                                    "value": "1",
                                    "disabled": true
                                },
                                {
                                    "key": "per_page",
                                    "value": "20",
                                    "disabled": true
                                }
                            ]
                        }
                    }
                },
                {
                    "name": "Emitir guía (crea, envía y consulta en una llamada)",
                    "request": {
                        "method": "POST",
                        "header": [
                            {
                                "key": "Content-Type",
                                "value": "application/json"
                            },
                            {
                                "key": "Idempotency-Key",
                                "value": "{{$guid}}",
                                "description": "Única por operación: un reintento con la misma clave no emite dos veces."
                            }
                        ],
                        "url": {
                            "raw": "{{base_url}}/guias",
                            "host": [
                                "{{base_url}}"
                            ],
                            "path": [
                                "guias"
                            ]
                        },
                        "body": {
                            "mode": "raw",
                            "raw": "{\n    \"serie_documento\": \"T001\",\n    \"numero_documento\": \"#\",\n    \"fecha_de_emision\": \"2026-11-03\",\n    \"hora_de_emision\": \"09:00:00\",\n    \"codigo_tipo_documento\": \"09\",\n    \"datos_del_cliente_o_receptor\": {\n        \"codigo_tipo_documento_identidad\": \"6\",\n        \"numero_documento\": \"20601234567\",\n        \"apellidos_y_nombres_o_razon_social\": \"CONSTRUCTORA ANDINA S.A.C.\"\n    },\n    \"codigo_modo_transporte\": \"02\",\n    \"codigo_motivo_traslado\": \"01\",\n    \"fecha_de_traslado\": \"2026-11-03\",\n    \"peso_total\": 1000,\n    \"unidad_peso_total\": \"KGM\",\n    \"direccion_partida\": {\n        \"ubigeo\": \"150101\",\n        \"direccion\": \"Av. Lima 123\",\n        \"codigo_del_domicilio_fiscal\": \"0000\"\n    },\n    \"direccion_llegada\": {\n        \"ubigeo\": \"150132\",\n        \"direccion\": \"Jr. Las Obras 456\",\n        \"codigo_del_domicilio_fiscal\": \"0000\"\n    },\n    \"chofer\": {\n        \"codigo_tipo_documento_identidad\": \"1\",\n        \"numero_documento\": \"40123456\",\n        \"nombres\": \"Luis Quispe\",\n        \"numero_licencia\": \"Q40123456\"\n    },\n    \"vehiculo\": {\n        \"numero_de_placa\": \"ABC123\"\n    },\n    \"items\": [\n        {\n            \"codigo_interno\": \"CEM-42\",\n            \"descripcion\": \"Cemento 42.5 kg\",\n            \"unidad_de_medida\": \"NIU\",\n            \"cantidad\": 40\n        }\n    ]\n}",
                            "options": {
                                "raw": {
                                    "language": "json"
                                }
                            }
                        },
                        "description": "El JSON de `POST /api/dispatches`. Si SUNAT aún no responde el ticket, el estado es `pendiente`: consulta con\n`GET /guias/{id}`. Alcance `guias.emitir`; funciones `sales.dispatches.create` y `sales.dispatches.emit`."
                    }
                },
                {
                    "name": "Consultar una guía (si está pendiente, consulta el ticket en SUNAT)",
                    "request": {
                        "method": "GET",
                        "header": [],
                        "url": {
                            "raw": "{{base_url}}/guias/:id",
                            "host": [
                                "{{base_url}}"
                            ],
                            "path": [
                                "guias",
                                ":id"
                            ],
                            "variable": [
                                {
                                    "key": "id",
                                    "description": "Id numérico o external_id (UUID)"
                                }
                            ]
                        }
                    }
                },
                {
                    "name": "Reintentar el envío de una guía registrada",
                    "request": {
                        "method": "POST",
                        "header": [
                            {
                                "key": "Idempotency-Key",
                                "value": "{{$guid}}",
                                "description": "Única por operación: un reintento con la misma clave no emite dos veces."
                            }
                        ],
                        "url": {
                            "raw": "{{base_url}}/guias/:id/enviar",
                            "host": [
                                "{{base_url}}"
                            ],
                            "path": [
                                "guias",
                                ":id",
                                "enviar"
                            ],
                            "variable": [
                                {
                                    "key": "id",
                                    "description": "Id numérico o external_id (UUID)"
                                }
                            ]
                        }
                    }
                },
                {
                    "name": "PDF de la guía",
                    "request": {
                        "method": "GET",
                        "header": [],
                        "url": {
                            "raw": "{{base_url}}/guias/:id/pdf",
                            "host": [
                                "{{base_url}}"
                            ],
                            "path": [
                                "guias",
                                ":id",
                                "pdf"
                            ],
                            "variable": [
                                {
                                    "key": "id",
                                    "description": "Id numérico o external_id (UUID)"
                                }
                            ]
                        }
                    }
                },
                {
                    "name": "XML firmado de la guía",
                    "request": {
                        "method": "GET",
                        "header": [],
                        "url": {
                            "raw": "{{base_url}}/guias/:id/xml",
                            "host": [
                                "{{base_url}}"
                            ],
                            "path": [
                                "guias",
                                ":id",
                                "xml"
                            ],
                            "variable": [
                                {
                                    "key": "id",
                                    "description": "Id numérico o external_id (UUID)"
                                }
                            ]
                        }
                    }
                },
                {
                    "name": "CDR de la guía",
                    "request": {
                        "method": "GET",
                        "header": [],
                        "url": {
                            "raw": "{{base_url}}/guias/:id/cdr",
                            "host": [
                                "{{base_url}}"
                            ],
                            "path": [
                                "guias",
                                ":id",
                                "cdr"
                            ],
                            "variable": [
                                {
                                    "key": "id",
                                    "description": "Id numérico o external_id (UUID)"
                                }
                            ]
                        }
                    }
                }
            ]
        },
        {
            "name": "Otros documentos",
            "description": "Retenciones (20), percepciones (40), liquidaciones de compra (04), notas de venta y cotizaciones.",
            "item": [
                {
                    "name": "Emitir comprobante de retención (20)",
                    "request": {
                        "method": "POST",
                        "header": [
                            {
                                "key": "Content-Type",
                                "value": "application/json"
                            },
                            {
                                "key": "Idempotency-Key",
                                "value": "{{$guid}}",
                                "description": "Única por operación: un reintento con la misma clave no emite dos veces."
                            }
                        ],
                        "url": {
                            "raw": "{{base_url}}/retenciones",
                            "host": [
                                "{{base_url}}"
                            ],
                            "path": [
                                "retenciones"
                            ]
                        },
                        "body": {
                            "mode": "raw",
                            "raw": "{}",
                            "options": {
                                "raw": {
                                    "language": "json"
                                }
                            }
                        },
                        "description": "El JSON de `POST /api/retentions`. Función `sales.advanced_documents.create`."
                    }
                },
                {
                    "name": "Emitir comprobante de percepción (40)",
                    "request": {
                        "method": "POST",
                        "header": [
                            {
                                "key": "Content-Type",
                                "value": "application/json"
                            },
                            {
                                "key": "Idempotency-Key",
                                "value": "{{$guid}}",
                                "description": "Única por operación: un reintento con la misma clave no emite dos veces."
                            }
                        ],
                        "url": {
                            "raw": "{{base_url}}/percepciones",
                            "host": [
                                "{{base_url}}"
                            ],
                            "path": [
                                "percepciones"
                            ]
                        },
                        "body": {
                            "mode": "raw",
                            "raw": "{}",
                            "options": {
                                "raw": {
                                    "language": "json"
                                }
                            }
                        },
                        "description": "El JSON de `POST /api/perceptions`."
                    }
                },
                {
                    "name": "Emitir liquidación de compra (04)",
                    "request": {
                        "method": "POST",
                        "header": [
                            {
                                "key": "Content-Type",
                                "value": "application/json"
                            },
                            {
                                "key": "Idempotency-Key",
                                "value": "{{$guid}}",
                                "description": "Única por operación: un reintento con la misma clave no emite dos veces."
                            }
                        ],
                        "url": {
                            "raw": "{{base_url}}/liquidaciones-compra",
                            "host": [
                                "{{base_url}}"
                            ],
                            "path": [
                                "liquidaciones-compra"
                            ]
                        },
                        "body": {
                            "mode": "raw",
                            "raw": "{}",
                            "options": {
                                "raw": {
                                    "language": "json"
                                }
                            }
                        },
                        "description": "El JSON de `POST /api/purchase-settlements`."
                    }
                },
                {
                    "name": "Registrar nota de venta",
                    "request": {
                        "method": "POST",
                        "header": [
                            {
                                "key": "Content-Type",
                                "value": "application/json"
                            },
                            {
                                "key": "Idempotency-Key",
                                "value": "{{$guid}}",
                                "description": "Única por operación: un reintento con la misma clave no emite dos veces."
                            }
                        ],
                        "url": {
                            "raw": "{{base_url}}/notas-venta",
                            "host": [
                                "{{base_url}}"
                            ],
                            "path": [
                                "notas-venta"
                            ]
                        },
                        "body": {
                            "mode": "raw",
                            "raw": "{}",
                            "options": {
                                "raw": {
                                    "language": "json"
                                }
                            }
                        },
                        "description": "Con el JSON de los comprobantes (sin `codigo_tipo_documento`), `serie_documento` de notas de venta (NV01…) y\n`origen` cotización o pedido. Para facturarla después: `POST /comprobantes` con `origen: {tipo: nota_venta, id}`.\nFunción `sales.sale_notes.create`."
                    }
                },
                {
                    "name": "Registrar cotización",
                    "request": {
                        "method": "POST",
                        "header": [
                            {
                                "key": "Content-Type",
                                "value": "application/json"
                            },
                            {
                                "key": "Idempotency-Key",
                                "value": "{{$guid}}",
                                "description": "Única por operación: un reintento con la misma clave no emite dos veces."
                            }
                        ],
                        "url": {
                            "raw": "{{base_url}}/cotizaciones",
                            "host": [
                                "{{base_url}}"
                            ],
                            "path": [
                                "cotizaciones"
                            ]
                        },
                        "body": {
                            "mode": "raw",
                            "raw": "{}",
                            "options": {
                                "raw": {
                                    "language": "json"
                                }
                            }
                        },
                        "description": "Con el JSON de los comprobantes, sin serie; `fecha_de_vencimiento`, `fecha_de_entrega` y `observaciones` opcionales."
                    }
                }
            ]
        },
        {
            "name": "Catálogo",
            "item": [
                {
                    "name": "Listar clientes",
                    "request": {
                        "method": "GET",
                        "header": [],
                        "url": {
                            "raw": "{{base_url}}/clientes",
                            "host": [
                                "{{base_url}}"
                            ],
                            "path": [
                                "clientes"
                            ],
                            "query": [
                                {
                                    "key": "buscar",
                                    "disabled": true
                                },
                                {
                                    "key": "page",
                                    "value": "1",
                                    "disabled": true
                                },
                                {
                                    "key": "per_page",
                                    "value": "20",
                                    "disabled": true
                                }
                            ]
                        }
                    }
                },
                {
                    "name": "Crear cliente",
                    "request": {
                        "method": "POST",
                        "header": [
                            {
                                "key": "Content-Type",
                                "value": "application/json"
                            },
                            {
                                "key": "Idempotency-Key",
                                "value": "{{$guid}}",
                                "description": "Única por operación: un reintento con la misma clave no emite dos veces."
                            }
                        ],
                        "url": {
                            "raw": "{{base_url}}/clientes",
                            "host": [
                                "{{base_url}}"
                            ],
                            "path": [
                                "clientes"
                            ]
                        },
                        "body": {
                            "mode": "raw",
                            "raw": "{\n    \"tipo_documento\": \"6\",\n    \"numero_documento\": \"20601234567\",\n    \"nombre\": \"BODEGA LIMA S.A.C.\",\n    \"direccion\": \"Av. Lima 1\",\n    \"ubigeo\": \"150101\",\n    \"correo\": \"compras@bodega.pe\"\n}",
                            "options": {
                                "raw": {
                                    "language": "json"
                                }
                            }
                        }
                    }
                },
                {
                    "name": "Consultar cliente por número de documento",
                    "request": {
                        "method": "GET",
                        "header": [],
                        "url": {
                            "raw": "{{base_url}}/clientes/:numero",
                            "host": [
                                "{{base_url}}"
                            ],
                            "path": [
                                "clientes",
                                ":numero"
                            ],
                            "variable": [
                                {
                                    "key": "numero",
                                    "description": "RUC, DNI u otro documento"
                                }
                            ]
                        }
                    }
                },
                {
                    "name": "Cambiar datos del cliente (el documento no cambia)",
                    "request": {
                        "method": "PUT",
                        "header": [
                            {
                                "key": "Content-Type",
                                "value": "application/json"
                            },
                            {
                                "key": "Idempotency-Key",
                                "value": "{{$guid}}",
                                "description": "Única por operación: un reintento con la misma clave no emite dos veces."
                            }
                        ],
                        "url": {
                            "raw": "{{base_url}}/clientes/:numero",
                            "host": [
                                "{{base_url}}"
                            ],
                            "path": [
                                "clientes",
                                ":numero"
                            ],
                            "variable": [
                                {
                                    "key": "numero",
                                    "description": "RUC, DNI u otro documento"
                                }
                            ]
                        },
                        "body": {
                            "mode": "raw",
                            "raw": "{}",
                            "options": {
                                "raw": {
                                    "language": "json"
                                }
                            }
                        }
                    }
                },
                {
                    "name": "Listar productos",
                    "request": {
                        "method": "GET",
                        "header": [],
                        "url": {
                            "raw": "{{base_url}}/productos",
                            "host": [
                                "{{base_url}}"
                            ],
                            "path": [
                                "productos"
                            ],
                            "query": [
                                {
                                    "key": "buscar",
                                    "disabled": true
                                },
                                {
                                    "key": "page",
                                    "value": "1",
                                    "disabled": true
                                },
                                {
                                    "key": "per_page",
                                    "value": "20",
                                    "disabled": true
                                }
                            ]
                        }
                    }
                },
                {
                    "name": "Crear producto (nace sin stock)",
                    "request": {
                        "method": "POST",
                        "header": [
                            {
                                "key": "Content-Type",
                                "value": "application/json"
                            },
                            {
                                "key": "Idempotency-Key",
                                "value": "{{$guid}}",
                                "description": "Única por operación: un reintento con la misma clave no emite dos veces."
                            }
                        ],
                        "url": {
                            "raw": "{{base_url}}/productos",
                            "host": [
                                "{{base_url}}"
                            ],
                            "path": [
                                "productos"
                            ]
                        },
                        "body": {
                            "mode": "raw",
                            "raw": "{\n    \"codigo_interno\": \"CAF-01\",\n    \"descripcion\": \"Café 250 g\",\n    \"precio_unitario\": 18.5,\n    \"unidad_de_medida\": \"NIU\",\n    \"codigo_tipo_afectacion_igv\": \"10\"\n}",
                            "options": {
                                "raw": {
                                    "language": "json"
                                }
                            }
                        }
                    }
                },
                {
                    "name": "Consultar producto",
                    "request": {
                        "method": "GET",
                        "header": [],
                        "url": {
                            "raw": "{{base_url}}/productos/:id",
                            "host": [
                                "{{base_url}}"
                            ],
                            "path": [
                                "productos",
                                ":id"
                            ],
                            "variable": [
                                {
                                    "key": "id",
                                    "description": "Id o código interno"
                                }
                            ]
                        }
                    }
                },
                {
                    "name": "Cambiar producto (cambiar el precio pide catalog.items.prices.update)",
                    "request": {
                        "method": "PUT",
                        "header": [
                            {
                                "key": "Content-Type",
                                "value": "application/json"
                            },
                            {
                                "key": "Idempotency-Key",
                                "value": "{{$guid}}",
                                "description": "Única por operación: un reintento con la misma clave no emite dos veces."
                            }
                        ],
                        "url": {
                            "raw": "{{base_url}}/productos/:id",
                            "host": [
                                "{{base_url}}"
                            ],
                            "path": [
                                "productos",
                                ":id"
                            ],
                            "variable": [
                                {
                                    "key": "id",
                                    "description": "Id o código interno"
                                }
                            ]
                        },
                        "body": {
                            "mode": "raw",
                            "raw": "{}",
                            "options": {
                                "raw": {
                                    "language": "json"
                                }
                            }
                        }
                    }
                },
                {
                    "name": "Stock por almacén, lote y serie",
                    "request": {
                        "method": "GET",
                        "header": [],
                        "url": {
                            "raw": "{{base_url}}/stock",
                            "host": [
                                "{{base_url}}"
                            ],
                            "path": [
                                "stock"
                            ],
                            "query": [
                                {
                                    "key": "producto",
                                    "description": "Id o código interno",
                                    "disabled": true
                                },
                                {
                                    "key": "almacen",
                                    "disabled": true
                                },
                                {
                                    "key": "page",
                                    "value": "1",
                                    "disabled": true
                                },
                                {
                                    "key": "per_page",
                                    "value": "20",
                                    "disabled": true
                                }
                            ]
                        },
                        "description": "Alcance `stock.leer`; función `inventory.read`."
                    }
                },
                {
                    "name": "Locales con sus series y almacenes",
                    "request": {
                        "method": "GET",
                        "header": [],
                        "url": {
                            "raw": "{{base_url}}/establecimientos",
                            "host": [
                                "{{base_url}}"
                            ],
                            "path": [
                                "establecimientos"
                            ]
                        }
                    }
                }
            ]
        },
        {
            "name": "Consultas",
            "item": [
                {
                    "name": "Consulta RUC (SUNAT)",
                    "request": {
                        "method": "GET",
                        "header": [],
                        "url": {
                            "raw": "{{base_url}}/consultas/ruc/:numero",
                            "host": [
                                "{{base_url}}"
                            ],
                            "path": [
                                "consultas",
                                "ruc",
                                ":numero"
                            ],
                            "variable": [
                                {
                                    "key": "numero"
                                }
                            ]
                        }
                    }
                },
                {
                    "name": "Consulta DNI (RENIEC)",
                    "request": {
                        "method": "GET",
                        "header": [],
                        "url": {
                            "raw": "{{base_url}}/consultas/dni/:numero",
                            "host": [
                                "{{base_url}}"
                            ],
                            "path": [
                                "consultas",
                                "dni",
                                ":numero"
                            ],
                            "variable": [
                                {
                                    "key": "numero"
                                }
                            ]
                        }
                    }
                },
                {
                    "name": "Tipo de cambio SUNAT",
                    "request": {
                        "method": "GET",
                        "header": [],
                        "url": {
                            "raw": "{{base_url}}/consultas/tipo-cambio",
                            "host": [
                                "{{base_url}}"
                            ],
                            "path": [
                                "consultas",
                                "tipo-cambio"
                            ],
                            "query": [
                                {
                                    "key": "fecha",
                                    "disabled": true
                                }
                            ]
                        }
                    }
                }
            ]
        },
        {
            "name": "Webhooks",
            "item": [
                {
                    "name": "Listar webhooks",
                    "request": {
                        "method": "GET",
                        "header": [],
                        "url": {
                            "raw": "{{base_url}}/webhooks",
                            "host": [
                                "{{base_url}}"
                            ],
                            "path": [
                                "webhooks"
                            ]
                        }
                    }
                },
                {
                    "name": "Crear webhook (el secreto se muestra una vez)",
                    "request": {
                        "method": "POST",
                        "header": [
                            {
                                "key": "Content-Type",
                                "value": "application/json"
                            },
                            {
                                "key": "Idempotency-Key",
                                "value": "{{$guid}}",
                                "description": "Única por operación: un reintento con la misma clave no emite dos veces."
                            }
                        ],
                        "url": {
                            "raw": "{{base_url}}/webhooks",
                            "host": [
                                "{{base_url}}"
                            ],
                            "path": [
                                "webhooks"
                            ]
                        },
                        "body": {
                            "mode": "raw",
                            "raw": "{\n    \"url\": \"https://mi-sistema.pe/avisos-sfp\",\n    \"eventos\": [\n        \"comprobante.aceptado\",\n        \"comprobante.rechazado\"\n    ]\n}",
                            "options": {
                                "raw": {
                                    "language": "json"
                                }
                            }
                        }
                    }
                },
                {
                    "name": "Borrar webhook",
                    "request": {
                        "method": "DELETE",
                        "header": [],
                        "url": {
                            "raw": "{{base_url}}/webhooks/:id",
                            "host": [
                                "{{base_url}}"
                            ],
                            "path": [
                                "webhooks",
                                ":id"
                            ],
                            "variable": [
                                {
                                    "key": "id"
                                }
                            ]
                        }
                    }
                },
                {
                    "name": "Entregas de un webhook",
                    "request": {
                        "method": "GET",
                        "header": [],
                        "url": {
                            "raw": "{{base_url}}/webhooks/:id/entregas",
                            "host": [
                                "{{base_url}}"
                            ],
                            "path": [
                                "webhooks",
                                ":id",
                                "entregas"
                            ],
                            "query": [
                                {
                                    "key": "estado",
                                    "value": "pendiente",
                                    "disabled": true
                                },
                                {
                                    "key": "page",
                                    "value": "1",
                                    "disabled": true
                                }
                            ],
                            "variable": [
                                {
                                    "key": "id"
                                }
                            ]
                        }
                    }
                },
                {
                    "name": "Reenviar una entrega",
                    "request": {
                        "method": "POST",
                        "header": [
                            {
                                "key": "Idempotency-Key",
                                "value": "{{$guid}}",
                                "description": "Única por operación: un reintento con la misma clave no emite dos veces."
                            }
                        ],
                        "url": {
                            "raw": "{{base_url}}/webhooks/entregas/:id/reenviar",
                            "host": [
                                "{{base_url}}"
                            ],
                            "path": [
                                "webhooks",
                                "entregas",
                                ":id",
                                "reenviar"
                            ],
                            "variable": [
                                {
                                    "key": "id"
                                }
                            ]
                        }
                    }
                }
            ]
        }
    ]
}