{
    "openapi": "3.1.2",
    "info": {
        "title": "API de integraciones de Saleya",
        "version": "1",
        "description": "Conectá un ERP, un sistema contable, un marketplace o tu propio servicio a una tienda. Cada solicitud lleva el token de una aplicación, y el token determina la tienda."
    },
    "servers": [
        {
            "url": "https://api.saleya.app/v1"
        }
    ],
    "security": [
        {
            "apiToken": []
        }
    ],
    "tags": [
        {
            "name": "Me",
            "x-displayName": "Aplicación y token",
            "description": "En nombre de quién habla el token: la aplicación, sus scopes, locales y límites. La primera llamada: muestra si el token funciona y qué scopes faltan."
        },
        {
            "name": "Store",
            "x-displayName": "Tienda",
            "description": "Con qué se leen todas las demás respuestas: la moneda de los importes, la zona horaria de las fechas y los idiomas del contenido."
        },
        {
            "name": "Locations",
            "x-displayName": "Locales",
            "description": "Locales de la tienda: tiendas, depósitos, cocinas y puntos de retiro. El stock, los pedidos y los retiros los nombran."
        },
        {
            "name": "Categories",
            "x-displayName": "Categorías",
            "description": "Categorías del catálogo como lista plana: el árbol se arma con parent_id. Se crean, cambian, archivan y vinculan por el ID externo."
        },
        {
            "name": "Products",
            "x-displayName": "Productos",
            "description": "Fichas de producto: nombres, descripciones, categorías, opciones y fotos. Las variantes tienen sus endpoints; el producto se escribe junto con ellas."
        },
        {
            "name": "Variants",
            "x-displayName": "Variantes",
            "description": "Lo que se vende y se guarda en stock: SKU, códigos de barras, precios, unidad y forma de venta. Cambian bajo la versión de la ficha del producto."
        },
        {
            "name": "ProductMedia",
            "x-displayName": "Fotos del producto",
            "description": "La galería de un producto: agregar una foto por URL, reordenar, elegir la principal, quitar."
        },
        {
            "name": "MediaImports",
            "x-displayName": "Descargas de fotos",
            "description": "Las fotos agregadas por URL se descargan en segundo plano; la descarga muestra su estado y el motivo de una falla."
        },
        {
            "name": "ModifierGroups",
            "x-displayName": "Grupos de modificadores",
            "description": "Elecciones para un ítem: salsas, extras, tamaño de porción. El grupo fija los límites de la elección; las opciones, el recargo y la composición."
        },
        {
            "name": "ProductModifierGroups",
            "x-displayName": "Modificadores del producto",
            "description": "Qué grupos de modificadores tiene un producto, en orden, con su regla de elección y los recargos de opciones por variante."
        },
        {
            "name": "RecommendationRules",
            "x-displayName": "Reglas de recomendaciones",
            "description": "Qué ofrecer junto a los productos de una categoría o colección, por prioridad: la lista propia del producto, las reglas en orden y la selección automática."
        },
        {
            "name": "TaxClasses",
            "x-displayName": "Clases de impuesto",
            "description": "Clases de impuesto de la tienda a las que remiten los productos con tax_class_id: el tipo de impuesto y su alícuota."
        },
        {
            "name": "PriceLists",
            "x-displayName": "Listas de precios",
            "description": "Listas de precios de local y mayoristas: un porcentaje sobre el precio base o sobre el costo, con redondeo. Precios y recargos fijos en feeds propios."
        },
        {
            "name": "PriceListItems",
            "x-displayName": "Precios fijos de listas",
            "description": "Precios fijos de variantes en listas de precios, por encima de la regla: el precio en la moneda de la lista y en la moneda de la tienda."
        },
        {
            "name": "PriceListModifierItems",
            "x-displayName": "Recargos fijos de listas",
            "description": "Recargos fijos de opciones de modificadores en listas de precios: para una variante o para todas, en la moneda de la lista y en la de la tienda."
        },
        {
            "name": "InventoryLevels",
            "x-displayName": "Stock",
            "description": "Stock de una variante en un local: leer los niveles, fijar el stock físico después de un conteo, ingresar o dar de baja mercadería."
        },
        {
            "name": "StockMovements",
            "x-displayName": "Movimientos de stock",
            "description": "Diario del stock físico del local: ventas, recepciones, bajas, inventarios, traslados y sus reversiones. Solo se agrega."
        },
        {
            "name": "Lots",
            "x-displayName": "Lotes",
            "description": "Lotes de producto: número del envase, vencimiento y disponibilidad. Los movimientos de stock y las líneas de documentos apuntan al lote."
        },
        {
            "name": "LocationTransfers",
            "x-displayName": "Traslados",
            "description": "Traslados de mercadería entre locales de la tienda: un documento registrado con líneas. Un error se corrige con un traslado inverso."
        },
        {
            "name": "Stocktakes",
            "x-displayName": "Inventarios",
            "description": "Inventarios de un local: alcance, conteo ciego y estado desde el borrador hasta el registro. Las líneas tienen su propio feed."
        },
        {
            "name": "StocktakeLines",
            "x-displayName": "Líneas de inventario",
            "description": "Lo que encontró el conteo: stock esperado y contado por artículo y lote, la diferencia, el ajuste aplicado y el stock del local después del registro."
        },
        {
            "name": "WriteOffReasons",
            "x-displayName": "Motivos de baja",
            "description": "Motivos de la tienda que nombra una baja: el motivo define el tipo contable y si hace falta un comentario."
        },
        {
            "name": "Orders",
            "x-displayName": "Pedidos",
            "description": "Pedidos de todos los canales: ítems, totales, estado y pago. El listado devuelve los cambios en orden de confirmación; el estado sigue las reglas de la tienda."
        },
        {
            "name": "OrderStatuses",
            "x-displayName": "Estados de pedido",
            "description": "Lista de estados de la tienda con los propios, el significado permanente de cada uno y las transiciones permitidas."
        },
        {
            "name": "DraftOrders",
            "x-displayName": "Borradores de pedido",
            "description": "Un pedido que prepara la aplicación: se calcula en vivo según catálogo, descuentos y envío, muestra qué impide confirmarlo y al confirmarse es un pedido."
        },
        {
            "name": "Payments",
            "x-displayName": "Pagos",
            "description": "Intentos de pago de los pedidos y su resultado. Aquí se confirman los pagos manuales que esperan el dinero."
        },
        {
            "name": "Refunds",
            "x-displayName": "Reembolsos",
            "description": "Reembolsos de pedidos: primero el cálculo, después el reembolso de ítems y envío; el dinero vuelve por los medios de pago, la mercadería vuelve al stock."
        },
        {
            "name": "DeliveryMethods",
            "x-displayName": "Métodos de envío",
            "description": "Métodos de envío de la tienda que nombran los pedidos y los borradores."
        },
        {
            "name": "ManualPaymentMethods",
            "x-displayName": "Medios de pago manuales",
            "description": "Medios de pago manuales de la tienda, como una transferencia bancaria, que nombran los pedidos y los pagos."
        },
        {
            "name": "Customers",
            "x-displayName": "Clientes",
            "description": "Clientes de la tienda con sus contactos, consentimiento de marketing y libreta de direcciones. Todo esto son datos personales bajo el scope customers:read."
        },
        {
            "name": "CustomerAddresses",
            "x-displayName": "Direcciones de clientes",
            "description": "La libreta de direcciones de un cliente: agregar, cambiar, marcar como principal, eliminar."
        },
        {
            "name": "CustomerFiscalProfiles",
            "x-displayName": "Datos fiscales de clientes",
            "description": "Datos fiscales con los que se emiten los comprobantes de los pedidos nuevos del cliente."
        },
        {
            "name": "CustomerGroups",
            "x-displayName": "Grupos de clientes",
            "description": "Grupos manuales de clientes a los que apuntan descuentos y envíos: VIP, mayoristas, personal. La membresía es el campo group_ids del cliente."
        },
        {
            "name": "LegalEntities",
            "x-displayName": "Razones sociales",
            "description": "Las razones sociales de la tienda: identificación y condición fiscal, emisoras de comprobantes. Los comprobantes y los períodos fiscales las referencian."
        },
        {
            "name": "FiscalDocuments",
            "x-displayName": "Comprobantes fiscales",
            "description": "Facturas, notas de crédito y de débito de las ventas tal como las emitió el fisco: número, fecha, impuestos, anulación y PDF."
        },
        {
            "name": "TaxPeriods",
            "x-displayName": "Períodos fiscales",
            "description": "Meses de la contabilidad fiscal de cada razón social: un período cerrado ya se declaró y sus datos no cambian más. Solo tiendas de Argentina."
        },
        {
            "name": "TaxWithholdings",
            "x-displayName": "Retenciones y percepciones",
            "description": "Impuesto que le retuvieron a la tienda, a computar, y el que retuvo la tienda a proveedores, a ingresar; certificados de la tienda en PDF."
        },
        {
            "name": "MoneyAccounts",
            "x-displayName": "Cuentas de dinero",
            "description": "Cuentas donde entra y de donde sale el dinero de la tienda: caja, banco, adquirente, billetera. El saldo está en la moneda de la cuenta."
        },
        {
            "name": "MoneyCategories",
            "x-displayName": "Categorías de dinero",
            "description": "Árbol de categorías de ingresos y egresos. Una categoría del sistema se reconoce por system_code, no por su nombre."
        },
        {
            "name": "MoneyTransactions",
            "x-displayName": "Movimientos de dinero",
            "description": "Libro de ingresos y egresos por cuenta: importe del asiento, registro que lo asentó y comprobante principal."
        },
        {
            "name": "MoneyTransfers",
            "x-displayName": "Transferencias entre cuentas",
            "description": "Transferencia de dinero de una cuenta a otra con comisión: alta, edición y baja. Sus partes son movimientos de dinero con transfer_id."
        },
        {
            "name": "ExchangeRates",
            "x-displayName": "Cotizaciones contables",
            "description": "Cotización de una moneda respecto de la moneda de la tienda en una fecha, la del libro de dinero; para revaluar cuentas y conciliar."
        },
        {
            "name": "PosShifts",
            "x-displayName": "Turnos de caja",
            "description": "Turnos de caja con el arqueo del cajón en cada moneda: fondo inicial, esperado, contado, diferencia y fondo que queda en el cajón."
        },
        {
            "name": "PosCashMovements",
            "x-displayName": "Movimientos del cajón",
            "description": "Diario del cajón del turno: ventas y devoluciones en efectivo, ingresos, retiros, depósitos, cambio y anulaciones. Solo se agrega."
        },
        {
            "name": "PosCashReasons",
            "x-displayName": "Motivos de ingreso y retiro",
            "description": "Motivos que nombran un ingreso o retiro de efectivo del cajón, con la categoría en la que el libro de movimientos de dinero lo asienta."
        },
        {
            "name": "GiftCards",
            "x-displayName": "Tarjetas de regalo",
            "description": "Las tarjetas de regalo de la tienda: valor nominal, saldo y deuda de la tienda por cada una. El código no se guarda ni se devuelve."
        },
        {
            "name": "GiftCardTransactions",
            "x-displayName": "Movimientos de tarjetas de regalo",
            "description": "Movimientos de las tarjetas: emisión, canje, devolución a la tarjeta, ajuste, anulación y bloqueo. Solo se agregan."
        },
        {
            "name": "CustomerAccounts",
            "x-displayName": "Cuentas corrientes de clientes",
            "description": "La cuenta corriente de cada cliente: saldo, límite de crédito, plazo de pago y resumen de un período con los vencimientos."
        },
        {
            "name": "CustomerAccountEntries",
            "x-displayName": "Movimientos de cuentas corrientes",
            "description": "Movimientos de las cuentas corrientes: venta a cuenta, cobro, devolución, baja por incobrable, compensación, retención y anulación. Solo se agregan."
        },
        {
            "name": "Suppliers",
            "x-displayName": "Proveedores",
            "description": "Directorio de proveedores: datos fiscales, moneda de compra, plazo de pago y modo de liquidación, con saldo y conciliación. Sin persona de contacto ni notas."
        },
        {
            "name": "SupplierBills",
            "x-displayName": "Comprobantes de proveedores",
            "description": "Cuentas a pagar: facturas, notas de débito y crédito, deudas por entregas sin factura, con IVA por alícuota, percepciones y líneas."
        },
        {
            "name": "SupplierBillPayments",
            "x-displayName": "Pagos de comprobantes de proveedores",
            "description": "Con qué y por cuánto se canceló un comprobante: dinero, compensación, nota de crédito, anticipo, gasto del libro o fuera del sistema."
        },
        {
            "name": "SettlementAgreements",
            "x-displayName": "Acuerdos de compensación",
            "description": "La base de una compensación: partes, compensación bilateral o tripartita, número y fecha del contrato, vigencia y calendario de la compensación periódica."
        },
        {
            "name": "SettlementOffsets",
            "x-displayName": "Compensaciones",
            "description": "Documento de compensación: lo que un cliente le debe a la tienda contra lo que la tienda le debe a un proveedor. Si se anula, queda con estado voided."
        },
        {
            "name": "SettlementOffsetLines",
            "x-displayName": "Líneas de compensaciones",
            "description": "Qué se compensó: un pedido o la deuda de la cuenta corriente del cliente y un comprobante del proveedor, con las cancelaciones que creó la compensación."
        },
        {
            "name": "PurchaseOrders",
            "x-displayName": "Órdenes de compra",
            "description": "Lo que la tienda pidió al proveedor: líneas con cantidad pedida, confirmada y recibida, precio y fecha de entrega prometida."
        },
        {
            "name": "GoodsReceipts",
            "x-displayName": "Recepciones",
            "description": "Mercadería recibida del proveedor: líneas con precio del remito y costo, correcciones de antes y después. La anulación marca voided_at."
        },
        {
            "name": "SupplierReturns",
            "x-displayName": "Devoluciones a proveedores",
            "description": "Mercadería enviada de vuelta al proveedor: líneas y compensación esperada y recibida, sea nota de crédito, reposición o dinero."
        },
        {
            "name": "ConsignmentSettlements",
            "x-displayName": "Liquidaciones de consignación",
            "description": "Rendición al proveedor de la mercadería en consignación vendida en un período, base de su factura: secciones, líneas y totales."
        },
        {
            "name": "Uploads",
            "x-displayName": "Cargas",
            "description": "Un archivo grande enviado por partes: la entrada de una operación masiva."
        },
        {
            "name": "BulkOperations",
            "x-displayName": "Operaciones masivas",
            "description": "Miles de registros en una solicitud: fijar stock, escribir productos, exportar pedidos. El resultado es NDJSON, una línea por entrada, descargable por rangos."
        },
        {
            "name": "Events",
            "x-displayName": "Eventos",
            "description": "Lo que cambió en la tienda en los últimos 30 días, con el registro tal como está ahora. Los mismos eventos van a los endpoints de webhooks."
        },
        {
            "name": "WebhookEndpoints",
            "x-displayName": "Endpoints de webhooks",
            "description": "Direcciones a las que la tienda envía eventos firmados según Standard Webhooks; el secreto de firma, su rotación y un evento de prueba."
        },
        {
            "name": "WebhookDeliveries",
            "x-displayName": "Entregas de webhooks",
            "description": "Qué salió hacia un endpoint, qué espera un reintento y qué falló, con las respuestas del receptor; una entrega se puede reintentar."
        }
    ],
    "x-tagGroups": [
        {
            "name": "Conceptos básicos",
            "tags": [
                "Me",
                "Store",
                "Locations"
            ]
        },
        {
            "name": "Catálogo",
            "tags": [
                "Categories",
                "Products",
                "Variants",
                "ProductMedia",
                "MediaImports",
                "ModifierGroups",
                "ProductModifierGroups",
                "RecommendationRules",
                "TaxClasses",
                "PriceLists",
                "PriceListItems",
                "PriceListModifierItems"
            ]
        },
        {
            "name": "Stock",
            "tags": [
                "InventoryLevels",
                "StockMovements",
                "Lots",
                "LocationTransfers",
                "Stocktakes",
                "StocktakeLines",
                "WriteOffReasons"
            ]
        },
        {
            "name": "Pedidos y pagos",
            "tags": [
                "Orders",
                "OrderStatuses",
                "DraftOrders",
                "Payments",
                "Refunds",
                "DeliveryMethods",
                "ManualPaymentMethods"
            ]
        },
        {
            "name": "Clientes",
            "tags": [
                "Customers",
                "CustomerAddresses",
                "CustomerFiscalProfiles",
                "CustomerGroups"
            ]
        },
        {
            "name": "Contabilidad",
            "tags": [
                "LegalEntities",
                "FiscalDocuments",
                "TaxPeriods",
                "TaxWithholdings",
                "MoneyAccounts",
                "MoneyCategories",
                "MoneyTransactions",
                "MoneyTransfers",
                "ExchangeRates",
                "PosShifts",
                "PosCashMovements",
                "PosCashReasons",
                "GiftCards",
                "GiftCardTransactions",
                "CustomerAccounts",
                "CustomerAccountEntries"
            ]
        },
        {
            "name": "Compras",
            "tags": [
                "Suppliers",
                "SupplierBills",
                "SupplierBillPayments",
                "SettlementAgreements",
                "SettlementOffsets",
                "SettlementOffsetLines",
                "PurchaseOrders",
                "GoodsReceipts",
                "SupplierReturns",
                "ConsignmentSettlements"
            ]
        },
        {
            "name": "Operaciones masivas",
            "tags": [
                "Uploads",
                "BulkOperations"
            ]
        },
        {
            "name": "Eventos y webhooks",
            "tags": [
                "Events",
                "WebhookEndpoints",
                "WebhookDeliveries"
            ]
        }
    ],
    "x-problem-types": [
        {
            "type": "api_token_expired",
            "status": 401,
            "title": "El token de la API venció",
            "description": "Pasó la fecha de vencimiento del token.",
            "resolution": "Emití un token nuevo en la configuración de la aplicación de la tienda y reemplazá el anterior en tu integración."
        },
        {
            "type": "api_token_invalid",
            "status": 401,
            "title": "El token de la API no es válido",
            "description": "El token tiene un formato incorrecto, su suma de verificación no coincide o no existe.",
            "resolution": "Verificá que copiaste el token completo. Si hace falta, emití uno nuevo en la configuración de la aplicación de la tienda."
        },
        {
            "type": "api_token_missing",
            "status": 401,
            "title": "Falta el token de la API",
            "description": "La solicitud no tiene el encabezado Authorization: Bearer. No se acepta el token en la query string.",
            "resolution": "Enviá el token de la aplicación en el encabezado: Authorization: Bearer <token>."
        },
        {
            "type": "api_token_revoked",
            "status": 401,
            "title": "El token de la API fue revocado",
            "description": "El token se revocó, la aplicación se eliminó, su miembro de servicio se desactivó o la tienda cerró.",
            "resolution": "Pedile a la tienda un token nuevo. Si la aplicación se eliminó, la tienda tiene que crearla otra vez."
        },
        {
            "type": "capability_disabled",
            "status": 403,
            "title": "Recurso no disponible para esta tienda",
            "description": "El recurso depende de una función de la tienda que esta tienda no tiene; capability indica cuál. Los períodos fiscales, por ejemplo, existen solo en tiendas de Argentina.",
            "resolution": "Esta tienda no tiene esos datos: salteá el recurso en la integración."
        },
        {
            "type": "forbidden",
            "status": 403,
            "title": "Prohibido",
            "description": "Una regla de acceso de la tienda rechazó la acción más allá de los scopes, por ejemplo en un local con el que la aplicación no trabaja.",
            "resolution": "Leé detail: nombra la regla. Si la acción es esperable, pedile a la tienda que amplíe el acceso de la aplicación."
        },
        {
            "type": "insufficient_scope",
            "status": 403,
            "title": "Falta un permiso",
            "description": "A la aplicación le falta el scope que necesita el endpoint; lo nombran required_scope y el encabezado WWW-Authenticate. Un endpoint que acepta cualquiera de varios scopes los lista en accepted_scopes: alcanza con uno.",
            "resolution": "Pedile a la tienda que le otorgue el scope a la aplicación. El token sigue siendo el mismo: los scopes son de la aplicación."
        },
        {
            "type": "integration_api_not_in_plan",
            "status": 403,
            "title": "La API para integraciones no está en el plan",
            "description": "El plan de la tienda no incluye la API de integraciones.",
            "resolution": "La tienda necesita un plan con la API de integraciones."
        },
        {
            "type": "ip_not_allowed",
            "status": 403,
            "title": "Dirección no permitida",
            "description": "La aplicación acepta solicitudes solo desde las direcciones IP listadas, y esta llegó desde otra.",
            "resolution": "Llamá desde una dirección permitida o pedile a la tienda que agregue la tuya en la configuración de la aplicación."
        },
        {
            "type": "not_found",
            "status": 404,
            "title": "No encontrado",
            "description": "El registro no existe o pertenece a otra tienda; una ruta desconocida recibe la misma respuesta.",
            "resolution": "Revisá el ID y la ruta. Los registros de otras tiendas nunca son visibles, ni con el ID exacto."
        },
        {
            "type": "method_not_allowed",
            "status": 405,
            "title": "Método no permitido",
            "description": "La ruta existe pero no acepta este método HTTP.",
            "resolution": "Usá el método de la operación que indica la referencia."
        },
        {
            "type": "address_book_full",
            "status": 409,
            "title": "La libreta de direcciones del cliente está llena",
            "description": "La libreta de direcciones del cliente llegó al límite de la tienda; limit es el tope.",
            "resolution": "Eliminá una dirección que no necesites y agregá la nueva."
        },
        {
            "type": "bulk_operation_finished",
            "status": 409,
            "title": "La operación ya terminó",
            "description": "La operación ya terminó y no se puede cancelar; operation_status es su estado.",
            "resolution": "Leé la operación y su resultado."
        },
        {
            "type": "bulk_operation_queue_full",
            "status": 409,
            "title": "La cola de operaciones de la app está llena",
            "description": "La aplicación ya tiene tantas operaciones masivas sin terminar como se permite; limit es el tope.",
            "resolution": "Esperá a que termine una de ellas y creá la siguiente."
        },
        {
            "type": "bulk_operation_result_unavailable",
            "status": 409,
            "title": "No hay archivo de resultado",
            "description": "El resultado de una operación de archivo aparece completo solo cuando está completed, y esta operación sigue en curso, falló o se canceló; operation_status es su estado.",
            "resolution": "Esperá el evento bulk_operation.finished o leé la operación: si está failed, el motivo está en error."
        },
        {
            "type": "consent_required",
            "status": 409,
            "title": "Hace falta consentir las consecuencias",
            "description": "La escritura cambiaría otros datos de la tienda: consent_kind nombra el tipo de consecuencia, consequences cuenta lo que cambiará y consent_token es la huella de lo mostrado.",
            "resolution": "Si las consecuencias son aceptables, repetí la solicitud con consent[<consent_kind>]=<consent_token>, conservando los consentimientos ya dados. Si cambiaron mientras tanto, vas a recibir un nuevo 409 con una huella nueva. En una línea de variante dentro de la escritura de un producto, el consentimiento se da al cambiar esa variante (variant_id)."
        },
        {
            "type": "customer_contact_in_use",
            "status": 409,
            "title": "El contacto ya pertenece a un cliente de la tienda",
            "description": "El teléfono o el email del cliente nuevo ya pertenece a un cliente de la tienda; los nombran field y existing_customer_id.",
            "resolution": "Usá el cliente existente: leelo por existing_customer_id."
        },
        {
            "type": "draft_order_closed",
            "status": 409,
            "title": "El borrador de pedido está cerrado",
            "description": "El borrador se confirmó o se canceló y ya no se puede cambiar ni confirmar; current da su estado y el pedido.",
            "resolution": "Si current.order_id tiene un pedido, ya está confirmado: leelo."
        },
        {
            "type": "external_id_archived",
            "status": 409,
            "title": "El registro con este ID externo está archivado",
            "description": "El ID externo pertenece a un registro archivado de la tienda; lo nombra external_id.",
            "resolution": "Pedile a la tienda que restaure el registro, o elegí otro ID."
        },
        {
            "type": "external_id_in_use",
            "status": 409,
            "title": "El ID externo está en uso",
            "description": "El ID externo ya lo usa otro registro vigente de esta aplicación; lo nombra external_id.",
            "resolution": "Leé el registro por su ID externo y actualizalo, o elegí otro ID."
        },
        {
            "type": "fiscal_document_annul_refused",
            "status": 409,
            "title": "No se puede anular la factura",
            "description": "No se puede anular la factura. code es el motivo: not_an_invoice — el comprobante no es una factura; not_issued — la factura no está emitida: la rechazada se reemite, la pendiente se cancela con el pedido; provider_disabled — el módulo fiscal de la tienda está apagado; already_voided — la factura ya está anulada o su nota espera emisión; nothing_to_void — la venta se devolvió completa y las notas de crédito dejaron la factura en cero. current.status es el estado del comprobante, current.annulling_document_id es la nota de anulación vigente en already_voided.",
            "resolution": "already_voided — seguí la nota current.annulling_document_id. Repetir no arregla los demás motivos."
        },
        {
            "type": "fiscal_document_dismiss_refused",
            "status": 409,
            "title": "No se puede sacar el comprobante de control",
            "description": "No se puede sacar el comprobante de control. code es el motivo: not_awaiting_decision — el comprobante no espera una decisión humana: se sacan los rechazados por el fisco y los emitidos con CAEA cuyo informe ARCA no acepta; already_resolved — el comprobante ya está fuera de control. current.status es el estado actual del comprobante.",
            "resolution": "Repetir no lo arregla: el sistema completa solo las fallas y las emisiones pendientes."
        },
        {
            "type": "fiscal_document_pdf_unavailable",
            "status": 409,
            "title": "El comprobante no tiene archivo",
            "description": "El comprobante no tiene archivo: no está emitido, o el proveedor no guardó ni el archivo ni los datos para generarlo; current.status es su estado.",
            "resolution": "Esperá el evento fiscal_document.issued y pedí el archivo de nuevo; un comprobante emitido sin archivo no lo va a tener."
        },
        {
            "type": "fiscal_document_reissue_refused",
            "status": 409,
            "title": "No se puede reemitir el comprobante",
            "description": "No se puede reemitir el comprobante. code es el motivo: not_reissuable — el comprobante no falló ni fue rechazado: espera emisión o ya está emitido; advance_applied — la seña de la reserva se aplicó al ticket y la factura del ticket ya la documenta; nothing_to_issue — el pedido se devolvió completo. current.status es el estado actual del comprobante.",
            "resolution": "not_reissuable — esperá el evento con el resultado de la emisión. Repetir no arregla los demás motivos: ese comprobante se saca de control con POST /v1/fiscal-documents/{document}/dismiss."
        },
        {
            "type": "idempotency_key_in_use",
            "status": 409,
            "title": "Hay una solicitud en curso con esta clave",
            "description": "Una solicitud con el mismo Idempotency-Key todavía se está ejecutando.",
            "resolution": "Esperá Retry-After segundos y repetí la solicitud con la misma clave: vas a recibir la respuesta guardada."
        },
        {
            "type": "in_use_conflict",
            "status": 409,
            "title": "Registro en uso",
            "description": "El registro no se puede eliminar: otros datos de la tienda todavía lo nombran.",
            "resolution": "Archivá el registro en lugar de eliminarlo: el archivo conserva los datos que lo nombran."
        },
        {
            "type": "invoice_issue_refused",
            "status": 409,
            "title": "No se puede emitir la factura del pedido ahora",
            "description": "No se puede emitir la factura del pedido ahora. code es el motivo: channel_not_first_party — el comprobante lo emite el canal de venta; entity_exempt — la razón social del pedido no emite comprobantes; issued_externally — el comprobante lo emite un POS externo; provider_disabled — el módulo fiscal de la tienda está apagado; not_covered — la venta todavía no está pagada; advance_applied — la seña de la reserva se aplicó al ticket y la factura del ticket la documenta; invoice_exists — la factura ya existe o espera emisión; invoice_rejected — el fisco rechazó la factura; nothing_to_issue — el pedido se devolvió completo; bill_required — la mesa tiene varias cuentas, la factura de una cuenta la emite el POS o el panel. current.invoice_id es la factura vigente del pedido en invoice_exists e invoice_rejected.",
            "resolution": "not_covered — esperá el pago; invoice_exists — seguí la factura current.invoice_id; invoice_rejected — corregí los datos y reemitila con POST /v1/fiscal-documents/{document}/reissue. Repetir no arregla los demás motivos."
        },
        {
            "type": "money_transaction_locked",
            "status": 409,
            "title": "El movimiento no se cambia a mano",
            "description": "La línea del libro no se edita ni se borra a mano: tiene documento de origen (entonces cambian solo la categoría, la contraparte y la descripción), es una línea interna del libro (saldo inicial, diferencia de cambio, reflejo de una tienda del grupo) o es parte de una transferencia. detail nombra el motivo, current.origin es el origen de la línea y current.transfer_id la transferencia.",
            "resolution": "Cambiá una línea con origen desde su documento y una parte de transferencia con /v1/money-transfers/{transfer_id}."
        },
        {
            "type": "order_cancel_refused",
            "status": 409,
            "title": "El pedido no se puede cancelar",
            "description": "El pedido no se puede cancelar ahora: su estado no lo permite, no se puede emitir una nota de crédito, el efectivo lo devuelve solo una caja con turno abierto o hay una suscripción pagada en curso.",
            "resolution": "Leé detail; current muestra el estado actual del pedido."
        },
        {
            "type": "order_transition_refused",
            "status": 409,
            "title": "El pedido no puede pasar a este estado",
            "description": "La tienda no permite este cambio de estado del pedido: las reglas de transición, un retiro sin cadete, un envío sin cadete o un saldo impago antes de completarlo. detail nombra el motivo, current muestra el estado actual.",
            "resolution": "Revisá allowed_next del estado actual en /v1/order-statuses y el motivo en detail."
        },
        {
            "type": "payment_not_confirmable",
            "status": 409,
            "title": "El pago no se puede confirmar",
            "description": "El pago ya no espera dinero o lo cierra su proveedor, no una persona; current muestra su estado.",
            "resolution": "Leé el pago: confirmable indica cuándo se puede confirmar a mano."
        },
        {
            "type": "plan_limit_reached",
            "status": 409,
            "title": "Se alcanzó el límite del plan",
            "description": "El plan de la tienda no permite más registros de este tipo; limit es el tope.",
            "resolution": "Archivá los registros que no necesites, o la tienda necesita un plan superior."
        },
        {
            "type": "purchase_order_refused",
            "status": 409,
            "title": "La orden de compra no acepta este comando",
            "description": "La orden de compra no acepta el comando en su estado actual: solo cambian el borrador y la orden colocada, solo se borra el borrador, se cancela la colocada, se cierra la recibida y se coloca solo con proveedor y local activos. detail dice el motivo y current.status tiene el estado actual de la orden.",
            "resolution": "Volvé a leer la orden y revisá su estado: borrá el borrador en lugar de cancelarlo y cancelá la colocada en lugar de borrarla."
        },
        {
            "type": "record_limit_reached",
            "status": 409,
            "title": "Se alcanzó el tope de registros",
            "description": "La tienda alcanzó el tope de registros de este tipo; limit es el tope. No depende del plan.",
            "resolution": "Eliminá en el panel de la tienda los registros de este tipo que no necesites: un plan superior no sube este tope."
        },
        {
            "type": "refund_not_confirmable",
            "status": 409,
            "title": "La devolución no espera confirmar un reintegro",
            "description": "El reembolso no tiene un pago manual que espere confirmación: el dinero lo devolvió un proveedor, una caja o el saldo.",
            "resolution": "Leé el reembolso: confirmable indica cuándo hace falta la confirmación."
        },
        {
            "type": "refund_refused",
            "status": 409,
            "title": "El pedido no se puede devolver",
            "description": "El estado del pedido no permite el reembolso: cancelado, sin dinero recibido, efectivo ya rendido a la caja, la tarjeta de la venta ya usada o una seña que retiene una reserva. detail nombra el motivo.",
            "resolution": "Volvé a calcular el reembolso (/v1/orders/{order}/refunds/calculate) y revisá refundable."
        },
        {
            "type": "shipment_in_progress",
            "status": 409,
            "title": "Ya hay una emisión de envío en curso",
            "description": "La emisión del envío del pedido ya está en cola o en curso, o el envío se está cancelando.",
            "resolution": "Esperá el evento order.updated: el resultado estará en shipment o shipment_attempt."
        },
        {
            "type": "shipment_label_unavailable",
            "status": 409,
            "title": "El envío no tiene etiqueta",
            "description": "El pedido no tiene envío, el transportista todavía no entregó la etiqueta o su archivo no está disponible.",
            "resolution": "Revisá shipment.label_available en el pedido: la etiqueta existe cuando es true."
        },
        {
            "type": "shipment_outcome_unknown",
            "status": 409,
            "title": "El resultado de la emisión anterior es desconocido",
            "description": "La conexión con el transportista se cortó después de la solicitud de emisión anterior y no se sabe si el envío se creó.",
            "resolution": "La tienda revisa la cuenta del transportista y registra el resultado en el panel; después se puede volver a emitir."
        },
        {
            "type": "shipment_refused",
            "status": 409,
            "title": "No se puede emitir el envío ahora",
            "description": "No se puede emitir el envío ahora: el método de entrega del pedido no tiene transportista integrado, el pedido ya no se despacha o espera el pago de su factura. code es el motivo (no_carrier, not_shippable, awaits_bill_payment), current es el estado actual del pedido.",
            "resolution": "Corregí el pedido según detail — cambiá el método de entrega o esperá el pago de la factura — y repetí la solicitud."
        },
        {
            "type": "shipment_tracking_refused",
            "status": 409,
            "title": "No se puede cargar el número de seguimiento a mano",
            "description": "El número de seguimiento del pedido no se puede cargar ni quitar a mano. code es el motivo: carrier_integrated — el número lo emite un transportista integrado, el envío se emite con POST /v1/orders/{order}/shipment; manual_tracking_unsupported — el método de envío del pedido no despacha con un servicio de envíos; order_closed — el pedido está cancelado o devuelto. current es el estado actual del pedido.",
            "resolution": "Con carrier_integrated, emití el envío en lugar de cargar un número; los otros motivos no se arreglan reintentando: ese pedido no lleva número de seguimiento."
        },
        {
            "type": "stock_held_by_write_offs",
            "status": 409,
            "title": "El stock está retenido por bajas pendientes de aprobación",
            "description": "Fijar el stock más bajo tomaría la cantidad retenida por bajas que esperan aprobación en la tienda.",
            "resolution": "Esperá a que la tienda apruebe o rechace las bajas y volvé a fijar el stock."
        },
        {
            "type": "stock_on_hand_changed",
            "status": 409,
            "title": "Cambió el stock físico",
            "description": "El stock físico no coincide con expected_on_hand: cambió después de leerlo. current.on_hand muestra el stock actual.",
            "resolution": "Volvé a contar sobre current.on_hand y enviá la solicitud otra vez con el nuevo expected_on_hand."
        },
        {
            "type": "supplier_bill_payment_locked",
            "status": 409,
            "title": "El pago del comprobante no se anula directamente",
            "description": "El pago del comprobante no se anula directamente: una compensación, una nota de crédito, un anticipo de la orden de compra y un egreso del libro los quita su propio documento, y una retención practicada con el pago en un período fiscal cerrado retiene también el pago. detail nombra el motivo, current.kind tiene el tipo de pago.",
            "resolution": "Quitá la compensación, la nota, el anticipo o el egreso desde su documento en el panel de la tienda. Una retención de un período cerrado se corrige con un documento del período siguiente."
        },
        {
            "type": "supplier_bill_refused",
            "status": 409,
            "title": "El comprobante de proveedor no acepta este comando",
            "description": "El comprobante de proveedor no acepta el comando en su estado actual: solo un borrador se cambia o se elimina, un comprobante registrado no se cambia, uno anulado no se registra, y las notas ya registradas contra un borrador impiden eliminarlo. Solo se aprueba un comprobante registrado, la aprobación no se revoca después del primer pago, y solo se paga uno registrado y aprobado. detail nombra el motivo, current.status tiene el estado actual del comprobante.",
            "resolution": "Volvé a leer el comprobante y revisá su estado: en vez de cambiar uno registrado, anulalo o emití una nota contra él."
        },
        {
            "type": "tax_withholding_certificate_unavailable",
            "status": 409,
            "title": "El registro no tiene certificado",
            "description": "La tienda emite certificado solo de lo que retuvo ella misma (direction practiced), desde su razón social: lo que le retuvieron a la tienda lo respalda el certificado del agente. current.direction es la dirección del registro y current.legal_entity_id, su razón social.",
            "resolution": "El certificado de lo que le retuvieron a la tienda pedíselo al agente que retuvo; un registro sin razón social no tiene certificado."
        },
        {
            "type": "unique_conflict",
            "status": 409,
            "title": "Valor repetido",
            "description": "Una solicitud simultánea tomó un valor único, como una dirección o un SKU, entre la verificación y la escritura.",
            "resolution": "Leé los datos actuales y repetí con otro valor."
        },
        {
            "type": "upload_offset_mismatch",
            "status": 409,
            "title": "La parte no empieza donde corresponde",
            "description": "El desplazamiento de la parte no es igual a lo que la carga ya recibió; received es el desplazamiento correcto.",
            "resolution": "Continuá desde received: enviá la parte que empieza en ese byte."
        },
        {
            "type": "webhook_endpoint_limit_reached",
            "status": 409,
            "title": "La app tiene el máximo de endpoints de webhook",
            "description": "La aplicación ya tiene tantos endpoints de webhooks como se permite; limit es el tope.",
            "resolution": "Eliminá un endpoint que no necesites o suscribí uno existente a más tipos de evento."
        },
        {
            "type": "cursor_expired",
            "status": 410,
            "title": "El cursor de sincronización venció",
            "description": "El cursor de sincronización es más antiguo que el plazo de conservación de las eliminaciones o se emitió antes de restaurar la base de la tienda.",
            "resolution": "Sincronizá de nuevo desde el principio sin cursor (o con updated_since) y guardá el nuevo cursor de sincronización."
        },
        {
            "type": "precondition_failed",
            "status": 412,
            "title": "El registro cambió",
            "description": "La versión en If-Match no es la actual: el registro cambió después de leerlo. Con If-None-Match: * — el registro ya existe.",
            "resolution": "Leé el registro otra vez, aplicá tu cambio a los datos nuevos y envialo con el nuevo ETag."
        },
        {
            "type": "range_not_satisfiable",
            "status": 416,
            "title": "El rango empieza después del resultado",
            "description": "El rango empieza más allá del resultado escrito; Content-Range da su largo.",
            "resolution": "En una operación en curso, esperá líneas nuevas y retomá desde el largo ya descargado."
        },
        {
            "type": "idempotency_key_required",
            "status": 422,
            "title": "Falta la clave de idempotencia",
            "description": "El método se ejecuta solo con el encabezado Idempotency-Key: un duplicado ante el fisco no se deshace.",
            "resolution": "Enviá una clave única, por ejemplo un UUID; si perdés la respuesta, repetí con la misma clave y el mismo cuerpo."
        },
        {
            "type": "idempotency_key_reused",
            "status": 422,
            "title": "La clave de idempotencia ya se usó",
            "description": "La clave ya se usó con otra solicitud: otro método, ruta o cuerpo.",
            "resolution": "Para una solicitud nueva, usá una clave nueva; con la misma clave repetí solo la misma solicitud."
        },
        {
            "type": "invalid_idempotency_key",
            "status": 422,
            "title": "La clave de idempotencia no es válida",
            "description": "El encabezado Idempotency-Key no se pudo leer: una clave tiene de 1 a 255 caracteres ASCII visibles, como token o cadena entre comillas.",
            "resolution": "Enviá una clave única por solicitud, por ejemplo un UUID."
        },
        {
            "type": "last_variant_of_product",
            "status": 422,
            "title": "Última variante del producto",
            "description": "Un producto no puede quedar sin variantes, así que su última variante no se puede archivar.",
            "resolution": "Archivá el producto (DELETE /v1/products/{product})."
        },
        {
            "type": "money_out_of_range",
            "status": 422,
            "title": "Importe fuera de rango",
            "description": "Un precio, una cantidad o una unidad dan un importe demasiado grande para calcularlo con exactitud.",
            "resolution": "Revisá el precio, la cantidad y la unidad de la variante."
        },
        {
            "type": "validation_error",
            "status": 422,
            "title": "Solicitud inválida",
            "description": "Un campo o parámetro es inválido o desconocido; errors lista los mensajes por campo.",
            "resolution": "Corregí los campos nombrados en errors. Los campos desconocidos se rechazan, no se ignoran."
        },
        {
            "type": "precondition_required",
            "status": 428,
            "title": "Falta If-Match",
            "description": "Cambiar un registro versionado necesita If-Match con su ETag; * no es una versión.",
            "resolution": "Leé el registro, tomá su ETag y envialo en If-Match."
        },
        {
            "type": "too_many_requests",
            "status": 429,
            "title": "Demasiadas solicitudes",
            "description": "Se agotó el límite; policy nombra el balde — app, store o rejected — y Retry-After indica cuánto esperar. rejected significa que se rechazaron demasiadas solicitudes de tu dirección en la entrada: falta el token, es inválido, fue revocado o venció, la dirección no está permitida, el plan no incluye la API.",
            "resolution": "Esperá Retry-After segundos. Repartí las solicitudes de forma pareja y usá operaciones masivas para grandes volúmenes; el encabezado RateLimit muestra lo que queda. Con rejected, corregí la causa que indicó el 401 o 403 anterior en vez de repetir la solicitud."
        },
        {
            "type": "server_error",
            "status": 500,
            "title": "Error del servidor",
            "description": "Una falla inesperada de nuestro lado. La solicitud no terminó.",
            "resolution": "Repetí más tarde con el mismo Idempotency-Key. Si persiste, escribí a soporte con el X-Request-Id."
        },
        {
            "type": "carrier_unavailable",
            "status": 503,
            "title": "El transportista no responde",
            "description": "El transportista no respondió a una solicitud que la tienda le hace en tu nombre (la etiqueta del envío en Mercado Envíos).",
            "resolution": "Volvé a intentar más tarde, según Retry-After."
        },
        {
            "type": "store_frozen",
            "status": 503,
            "title": "Tienda congelada",
            "description": "La tienda está congelada por falta de pago de la suscripción.",
            "resolution": "La tienda debe pagar su suscripción; las solicitudes vuelven a funcionar en cuanto lo haga."
        },
        {
            "type": "transient_conflict",
            "status": 503,
            "title": "Conflicto temporal",
            "description": "Un cambio simultáneo revirtió la solicitud completa; no se escribió nada.",
            "resolution": "Repetí después de Retry-After segundos."
        },
        {
            "type": "http_error",
            "status": null,
            "title": "Error HTTP",
            "description": "Un error HTTP sin tipo propio, como 503 durante un mantenimiento.",
            "resolution": "Actuá según el estado: con 503, repetí después de Retry-After segundos."
        }
    ],
    "x-scopes": [
        {
            "name": "catalog:read",
            "description": "Leer el catálogo: categorías, productos con sus variantes y fotos, reglas de recomendaciones, listas de precios de local con precios y recargos fijos.",
            "includes": [],
            "adds_fields_to": []
        },
        {
            "name": "catalog:write",
            "description": "Crear, cambiar y archivar categorías, productos, variantes, opciones y fotos de productos y reglas de recomendaciones; fijar la regla, los precios y los recargos de las listas de precios de local; seguir las descargas de fotos.",
            "includes": [
                "catalog:read"
            ],
            "adds_fields_to": []
        },
        {
            "name": "inventory:read",
            "description": "Leer el stock por local, el registro de movimientos de stock, los lotes, los traslados, los inventarios y los motivos de baja de la tienda.",
            "includes": [],
            "adds_fields_to": []
        },
        {
            "name": "inventory:write",
            "description": "Fijar el stock físico después de un conteo, ingresar mercadería y darla de baja.",
            "includes": [
                "inventory:read"
            ],
            "adds_fields_to": []
        },
        {
            "name": "orders:read",
            "description": "Leer pedidos, borradores, estados de pedido, métodos de envío y medios de pago manuales. Los contactos del cliente en los pedidos necesitan además customers:read.",
            "includes": [],
            "adds_fields_to": []
        },
        {
            "name": "orders:write",
            "description": "Crear y confirmar borradores, mover pedidos entre estados, cancelarlos y emitir sus envíos con el transportista y cargar el número de seguimiento de un servicio de envíos sin integración. Confirmar un borrador como pagado necesita además payments:write; cancelar un pedido con dinero cobrado, refunds:write.",
            "includes": [
                "orders:read"
            ],
            "adds_fields_to": []
        },
        {
            "name": "orders:wholesale",
            "description": "Condiciones mayoristas — el permiso del panel para llevar la venta mayorista: crear, cambiar y borrar listas de precios mayoristas, sus precios y recargos fijos, y asignar una lista mayorista a un cliente (con customers:write). Incluye orders:read, catalog:read y costs:read: una lista mayorista calcula el precio desde el costo. La venta mayorista no está disponible por la API.",
            "includes": [
                "orders:read",
                "catalog:read",
                "costs:read"
            ],
            "adds_fields_to": []
        },
        {
            "name": "customers:read",
            "description": "Leer clientes con su libreta de direcciones, datos fiscales y grupos, y ver los contactos, la dirección y el comentario del cliente en los pedidos y el receptor de los comprobantes fiscales.",
            "includes": [],
            "adds_fields_to": [
                "orders:read",
                "fiscal:read"
            ]
        },
        {
            "name": "customers:write",
            "description": "Crear y cambiar clientes, su libreta de direcciones y sus datos fiscales; gestionar los grupos de clientes y sus miembros.",
            "includes": [
                "customers:read"
            ],
            "adds_fields_to": []
        },
        {
            "name": "locations:read",
            "description": "Leer los locales de la tienda a los que la aplicación tiene acceso.",
            "includes": [],
            "adds_fields_to": []
        },
        {
            "name": "payments:read",
            "description": "Leer los pagos de los pedidos.",
            "includes": [],
            "adds_fields_to": []
        },
        {
            "name": "payments:write",
            "description": "Confirmar un pago manual como cobrado y confirmar un borrador como pagado.",
            "includes": [
                "payments:read"
            ],
            "adds_fields_to": []
        },
        {
            "name": "refunds:read",
            "description": "Leer los reembolsos de los pedidos.",
            "includes": [],
            "adds_fields_to": []
        },
        {
            "name": "refunds:write",
            "description": "Calcular y crear reembolsos, confirmar devoluciones manuales de dinero y cancelar pedidos con dinero cobrado.",
            "includes": [
                "refunds:read"
            ],
            "adds_fields_to": []
        },
        {
            "name": "costs:read",
            "description": "Agregar el costo a las variantes del catálogo y a los ítems de los pedidos, y mostrar las listas de precios mayoristas, que calculan el precio desde el costo. No abre endpoints propios y funciona solo junto con catalog:read u orders:read.",
            "includes": [],
            "adds_fields_to": [
                "catalog:read",
                "orders:read"
            ]
        },
        {
            "name": "fiscal:read",
            "description": "Leer las razones sociales de la tienda, los comprobantes fiscales con su PDF, los períodos fiscales y las retenciones y percepciones con los certificados de la tienda. El receptor del comprobante requiere además customers:read. Junto con orders:read agrega a los pedidos el comprobante de la caja externa.",
            "includes": [],
            "adds_fields_to": [
                "orders:read"
            ]
        },
        {
            "name": "fiscal:write",
            "description": "Emitir la factura de una venta cerrada, reemitir un comprobante tras una falla o un rechazo del fisco y sacar de control un comprobante rechazado. La emisión va al fisco: la clave de idempotencia es obligatoria.",
            "includes": [
                "fiscal:read"
            ],
            "adds_fields_to": []
        },
        {
            "name": "fiscal:annul",
            "description": "Anular facturas emitidas con una nota de crédito. Es irreversible: la nota queda en el fisco. No da escritura: emitir comprobantes y anularlos son permisos distintos.",
            "includes": [
                "fiscal:read"
            ],
            "adds_fields_to": []
        },
        {
            "name": "finance:read",
            "description": "Leer las cuentas de dinero con su saldo, las categorías, el libro de movimientos de dinero con su origen y comprobante principal, la cotización contable del día, los turnos de caja con su arqueo y el diario del cajón, las tarjetas de regalo con la deuda de la tienda y sus movimientos, y las cuentas corrientes de clientes con sus movimientos y su resumen.",
            "includes": [],
            "adds_fields_to": []
        },
        {
            "name": "finance:write",
            "description": "Registrar ingresos y egresos manuales, editarlos y borrarlos, transferir entre cuentas, categorizar el libro en lote y registrar cobros de cuentas corrientes con dinero ya recibido. Las cuentas y las categorías se manejan en el panel de la tienda.",
            "includes": [
                "finance:read"
            ],
            "adds_fields_to": []
        },
        {
            "name": "procurement:read",
            "description": "Lectura de proveedores con datos fiscales y condiciones de pago, comprobantes de proveedores con impuestos, líneas y saldo pendiente, pagos de comprobantes, saldos, conciliaciones, compensaciones, órdenes de compra, recepciones, devoluciones a proveedores y liquidaciones de consignación.",
            "includes": [],
            "adds_fields_to": []
        },
        {
            "name": "procurement:write",
            "description": "Crear y cambiar proveedores: datos fiscales, condiciones de pago e ID externo. Órdenes de compra: borrador, cambios, colocación, cancelación y cierre. Comprobantes de proveedores: borrador, cambios, eliminación del borrador, registro y anulación.",
            "includes": [
                "procurement:read"
            ],
            "adds_fields_to": []
        },
        {
            "name": "procurement:approve",
            "description": "Aprobar el pago de comprobantes de proveedores registrados y revocar la aprobación: sin ella el comprobante no se paga. No otorga escritura: cargar comprobantes y autorizar su pago son facultades distintas.",
            "includes": [
                "procurement:read"
            ],
            "adds_fields_to": []
        },
        {
            "name": "procurement:pay",
            "description": "Pago de comprobantes de proveedores aprobados fuera del sistema —cuando el dinero salió por fuera de las cuentas de la tienda, por ejemplo desde el banco del ERP— y anulación del pago. No otorga escritura ni aprobación: cargar comprobantes, autorizar su pago y pagarlos son facultades distintas.",
            "includes": [
                "procurement:read"
            ],
            "adds_fields_to": []
        },
        {
            "name": "webhooks:read",
            "description": "Leer el feed de eventos, los endpoints de webhooks y sus entregas.",
            "includes": [],
            "adds_fields_to": []
        },
        {
            "name": "webhooks:write",
            "description": "Crear, cambiar y eliminar endpoints de webhooks, obtener y rotar sus secretos, enviar eventos de prueba y reintentar entregas.",
            "includes": [
                "webhooks:read"
            ],
            "adds_fields_to": []
        },
        {
            "name": "bulk:read",
            "description": "Leer las operaciones masivas, descargar sus resultados y consultar las cargas.",
            "includes": [],
            "adds_fields_to": []
        },
        {
            "name": "bulk:write",
            "description": "Subir archivos, iniciar y cancelar operaciones masivas. Cada tipo de operación necesita además el scope de su recurso.",
            "includes": [
                "bulk:read"
            ],
            "adds_fields_to": []
        }
    ],
    "x-limits": [
        {
            "name": "page_size",
            "value": 250,
            "unit": "records",
            "description": "Registros en una página de un listado (limit)."
        },
        {
            "name": "live_tokens_per_app",
            "value": 2,
            "unit": "items",
            "description": "Tokens vigentes de una aplicación: uno en uso y otro en reemplazo."
        },
        {
            "name": "idempotency_key",
            "value": 24,
            "unit": "hours",
            "description": "Cuánto se guarda la respuesta a una solicitud con Idempotency-Key."
        },
        {
            "name": "sync_cursor",
            "value": 30,
            "unit": "days",
            "description": "Cuánto vale un cursor de sincronización; uno más viejo recibe 410 cursor_expired."
        },
        {
            "name": "events",
            "value": 30,
            "unit": "days",
            "description": "Cuánto se guardan los eventos en GET /v1/events."
        },
        {
            "name": "request_log",
            "value": 30,
            "unit": "days",
            "description": "Cuánto quedan las solicitudes en el registro de la aplicación."
        },
        {
            "name": "webhook_endpoints_per_app",
            "value": 10,
            "unit": "items",
            "description": "Endpoints de webhooks de una aplicación."
        },
        {
            "name": "webhook_timeout",
            "value": 10,
            "unit": "seconds",
            "description": "Cuánto espera una entrega de webhook la respuesta del endpoint."
        },
        {
            "name": "previous_webhook_secret",
            "value": 24,
            "unit": "hours",
            "description": "Cuánto sigue firmando el secreto anterior después de una rotación."
        },
        {
            "name": "webhook_retries",
            "value": 10,
            "unit": "items",
            "description": "Reintentos automáticos de una entrega de webhook fallida."
        },
        {
            "name": "webhook_retry_window",
            "value": 72,
            "unit": "hours",
            "description": "Cuánto duran, aproximadamente, los reintentos automáticos de una entrega."
        },
        {
            "name": "webhook_disable_after",
            "value": 72,
            "unit": "hours",
            "description": "Cuánto puede fallar un endpoint sin un solo éxito antes de que se desactive."
        },
        {
            "name": "bulk_operations_per_app",
            "value": 5,
            "unit": "items",
            "description": "Operaciones masivas de una aplicación en espera o en curso a la vez."
        },
        {
            "name": "bulk_input",
            "value": 268435456,
            "unit": "bytes",
            "description": "Tamaño del archivo de entrada de una operación masiva."
        },
        {
            "name": "bulk_line",
            "value": 1048576,
            "unit": "bytes",
            "description": "Tamaño de una línea de la entrada."
        },
        {
            "name": "upload_chunk",
            "value": 1048576,
            "unit": "bytes",
            "description": "Tamaño de una parte de una carga."
        },
        {
            "name": "bulk_retention",
            "value": 7,
            "unit": "days",
            "description": "Cuánto se guardan una operación masiva terminada y sus archivos."
        },
        {
            "name": "rejected_requests_per_minute",
            "value": 60,
            "unit": "items",
            "description": "Cuántas solicitudes por minuto de una misma dirección pueden rechazarse en la entrada (401, 403) antes de que la dirección reciba 429."
        }
    ],
    "x-changelog": [
        {
            "key": "feed-nulled-references",
            "date": "2026-11-20",
            "kind": "fixed",
            "title": "Las listas devuelven los registros cuya referencia vació una eliminación",
            "description": "Cuando eliminar un registro relacionado vaciaba una referencia de un registro de la lista (el tax_class_id de un producto al eliminar su clase impositiva, el location_id de una cuenta de dinero al eliminar su sucursal) o borraba una de sus filas anidadas (una línea de comprobante de proveedor, de recepción, de devolución al proveedor o de liquidación de consignación, una categoría del producto), el registro no avanzaba en el feed de cambios ni emitía .updated, y la copia de la integración se quedaba con el valor viejo. Ahora ese registro llega en la siguiente sincronización por cursor y, en los recursos con evento .updated, también como evento. El feed no repite los cambios anteriores a esta fecha: si tu copia guarda esas referencias o filas anidadas, leé una vez las listas indicadas de nuevo sin cursor.",
            "operations": [
                "orders.list",
                "payments.list",
                "refunds.list",
                "customers.list",
                "locations.list",
                "categories.list",
                "products.list",
                "variants.list",
                "modifier_groups.list",
                "recommendation_rules.list",
                "media_imports.list",
                "lots.list",
                "location_transfers.list",
                "fiscal_documents.list",
                "money_accounts.list",
                "money_categories.list",
                "pos_cash_movements.list",
                "gift_cards.list",
                "gift_card_transactions.list",
                "supplier_bills.list",
                "goods_receipts.list",
                "supplier_returns.list",
                "consignment_settlements.list"
            ]
        },
        {
            "key": "supplier-payment-withholdings",
            "date": "2026-11-20",
            "kind": "changed",
            "title": "Retenciones al pagar comprobantes de proveedor: jurisdicción y moneda",
            "description": "En POST /v1/supplier-bills/{supplier_bill}/payments/out-of-band, una retención turnover o municipal sin jurisdiction ahora se rechaza con 422: esa retención no entraba en la declaración de ninguna provincia. El importe de la retención sigue en la moneda del comprobante y se descuenta del pago al proveedor. Si el comprobante está en otra moneda, tax-withholdings recibe el importe y la base equivalentes en la moneda de la tienda a la cotización del día del pago; antes recibía el número en la moneda del comprobante. Sin cotización para ese día, el pago con retenciones se rechaza con 422.",
            "operations": [
                "supplier_bills.record_out_of_band_payment"
            ]
        },
        {
            "key": "group-transfer-movements",
            "date": "2026-11-20",
            "kind": "added",
            "title": "Traslados entre tiendas del grupo en el diario de stock",
            "description": "El diario de movimientos de stock incorpora los motivos group_transfer_out (envío a otra tienda del grupo), group_transfer_in (recepción desde ella) y group_transfer_return (el faltante de un traslado volvió al stock del remitente) y el tipo de documento group_transfer — la copia del traslado de esta tienda. El filtro document_type=group_transfer devuelve los movimientos de un traslado. /v1 no tiene un recurso propio de traslados.",
            "operations": [
                "stock_movements.list",
                "stock_movements.get"
            ]
        },
        {
            "key": "external-fiscal-document",
            "date": "2026-11-20",
            "kind": "added",
            "title": "Comprobante de la caja externa en pedidos",
            "description": "Los pedidos sumaron el campo external_fiscal_document: el comprobante de la venta en una caja externa (FuDo, Poster) que lo emite en lugar de nosotros, con la caja (issuer), el estado pending o issued y el número. El campo llega con el scope fiscal:read; esos pedidos no tienen comprobantes fiscales. Cuando el comprobante aparece o se emite, el pedido avanza en el feed y llega el evento order.updated; los pedidos con historial reciben el campo en una sola carga y también vuelven a pasar por el feed. La operación masiva orders.export incluye el campo si la operación se creó con el scope fiscal:read.",
            "operations": [
                "orders.list",
                "orders.get"
            ]
        },
        {
            "key": "fiscal-writes",
            "date": "2026-11-20",
            "kind": "added",
            "title": "Escritura de comprobantes fiscales",
            "description": "Nuevos scopes fiscal:write y fiscal:annul. Con fiscal:write, POST /v1/orders/{order}/invoice emite la factura de una venta cerrada, POST /v1/fiscal-documents/{document}/reissue reemite un comprobante tras una falla o un rechazo del fisco (una factura rechazada, con receptor corregido o refresh_receptor) y POST /v1/fiscal-documents/{document}/dismiss saca de control un comprobante rechazado. Con fiscal:annul, POST /v1/fiscal-documents/{document}/annul anula una factura emitida con una nota de crédito y un motivo reason. La emisión va al fisco en segundo plano: la respuesta es 202 con el comprobante y el resultado llega con los eventos fiscal_document.issued y fiscal_document.failed. Los comandos que van al fisco exigen el encabezado Idempotency-Key: sin él, 422 idempotency_key_required. Nuevos rechazos invoice_issue_refused, fiscal_document_reissue_refused, fiscal_document_dismiss_refused y fiscal_document_annul_refused. El comprobante fiscal sumó el objeto dismissal y annulment sumó comment; annulment.reason ahora es order_cancelled, advance_applied o manual: la lista anterior describía otros motivos.",
            "operations": [
                "fiscal_documents.issue_invoice",
                "fiscal_documents.reissue",
                "fiscal_documents.dismiss",
                "fiscal_documents.annul"
            ]
        },
        {
            "key": "wholesale-price-lists",
            "date": "2026-11-20",
            "kind": "added",
            "title": "Listas de precios mayoristas",
            "description": "Nuevo scope orders:wholesale — condiciones mayoristas, el permiso del panel para llevar la venta mayorista; incluye orders:read, catalog:read y costs:read. Con él POST /v1/price-lists crea una lista mayorista, DELETE /v1/price-lists/{price_list} la borra con If-Match (una lista asignada a clientes, con el consentimiento wholesale_price_list_buyers), y PATCH y los comandos de filas escriben una lista mayorista; en una mayorista PATCH cambia también name. POST /v1/customers/{customer}/wholesale-price-list asigna una lista mayorista a un cliente con su If-Match — necesita además customers:write. Los comandos de escritura de listas aceptan catalog:write u orders:wholesale, y se necesita el scope del tipo de lista: lo nombra el rechazo insufficient_scope; en un endpoint con varios scopes el rechazo los lista en accepted_scopes.",
            "operations": [
                "price_lists.create",
                "price_lists.delete",
                "customers.set_wholesale_price_list"
            ]
        },
        {
            "key": "price-list-writes",
            "date": "2026-11-20",
            "kind": "added",
            "title": "Escritura de listas de precios",
            "description": "Con catalog:write una lista de precios se escribe con If-Match de su versión: PATCH /v1/price-lists/{price_list} cambia su regla — adjustment_bp y el redondeo rounding —; los comandos POST /v1/price-lists/{price_list}/items y …/items/remove fijan y quitan precios de variantes, y …/modifier-items y …/modifier-items/remove, recargos de opciones de modificadores, hasta 1000 filas por solicitud en una sola operación. La respuesta es la lista con su nueva versión, y un lote envía un solo evento price_list.updated. Una fila en la moneda de la tienda se escribe con price y compare_at_price; una fila en la moneda de la lista, con list_price y list_compare_at_price. La app gestiona una lista de local si tiene acceso a todos sus locales; las listas mayoristas no se escriben con estos comandos.",
            "operations": [
                "price_lists.update",
                "price_lists.set_items",
                "price_lists.remove_items",
                "price_lists.set_modifier_items",
                "price_lists.remove_modifier_items"
            ]
        },
        {
            "key": "price-lists",
            "date": "2026-11-20",
            "kind": "added",
            "title": "Listas de precios",
            "description": "Con catalog:read hay listas de precios (GET /v1/price-lists) — de local y mayoristas, con su regla adjustment_bp y su redondeo rounding —, sus precios fijos de variantes (GET /v1/price-list-items) y sus recargos fijos de opciones de modificadores (GET /v1/price-list-modifier-items). Una lista mayorista calcula el precio desde el costo y solo se ve con costs:read; una lista de local la ve la app que tiene acceso a al menos uno de sus locales. El local tiene el campo price_list_id; el cliente, wholesale_price_list_id y un filtro del feed de clientes por él. Cambiar un precio o recargo fijo aumenta la versión de la lista. Eventos price_list.created, price_list.updated, price_list.deleted.",
            "operations": [
                "price_lists.list",
                "price_lists.get",
                "price_list_items.list",
                "price_list_items.get",
                "price_list_modifier_items.list",
                "price_list_modifier_items.get",
                "locations.list",
                "customers.list",
                "customers.get"
            ]
        },
        {
            "key": "customer-groups",
            "date": "2026-11-20",
            "kind": "added",
            "title": "Grupos de clientes",
            "description": "Con customers:read ahora hay grupos de clientes (GET /v1/customer-groups) con nombre, descripción y actividad, y el cliente tiene el campo group_ids y el feed de clientes el filtro group_id. Con customers:write los grupos se crean, se cambian con If-Match y se eliminan; eliminar un grupo lo desvincula de las reglas de descuento y de los envíos, y una regla que queda sin audiencia se desactiva. Los clientes se agregan a un grupo y se quitan con POST /v1/customer-groups/{customer_group}/members y …/members/remove. La membresía no mueve la versión del cliente: un cambio mueve al cliente en el feed y envía customer.updated. Eventos customer_group.created, customer_group.updated, customer_group.deleted.",
            "operations": [
                "customer_groups.list",
                "customer_groups.get",
                "customer_groups.create",
                "customer_groups.update",
                "customer_groups.delete",
                "customer_groups.add_members",
                "customer_groups.remove_members",
                "customers.list",
                "customers.get"
            ]
        },
        {
            "key": "order-shipment-tracking",
            "date": "2026-11-20",
            "kind": "added",
            "title": "Número de seguimiento de un servicio sin integración",
            "description": "POST /v1/orders/{order}/shipment/tracking con orders:write carga el número de seguimiento, el enlace y el nombre del servicio de un pedido que despacha un servicio de envíos sin integración; POST …/shipment/tracking/clear lo quita. El número está en shipment del pedido: carrier sumó el valor courier_service, y shipment y previous_shipments sumaron carrier_name — el servicio como lo nombró la tienda. El cliente ve el número en la página del pedido y lo recibe por mensaje si el pedido ya está en el servicio. Nuevo rechazo shipment_tracking_refused.",
            "operations": [
                "orders.set_shipment_tracking",
                "orders.clear_shipment_tracking",
                "orders.list",
                "orders.get"
            ]
        },
        {
            "key": "order-shipment-create",
            "date": "2026-11-20",
            "kind": "added",
            "title": "Emisión del envío por la API",
            "description": "POST /v1/orders/{order}/shipment emite el envío con el transportista del pedido con orders:write: la respuesta es 202 con el pedido, la emisión corre en segundo plano y el resultado llega con order.updated; si el envío ya existe, la respuesta es 200. shipment_attempt sumó los estados queued y failed y el campo error con el código y el texto del motivo. Nuevos problemas shipment_refused, shipment_in_progress y shipment_outcome_unknown.",
            "operations": [
                "orders.create_shipment",
                "orders.list",
                "orders.get"
            ]
        },
        {
            "key": "variants-list-price",
            "date": "2026-11-19",
            "kind": "added",
            "title": "Precio de la variante en la moneda de la lista",
            "description": "La variante tiene los campos list_price y list_price_currency: el precio tal como lo fijó el dueño y su moneda, cuando la tienda lleva la lista en otra moneda. En esa variante price en la moneda de la tienda lo calcula el sistema con la cotización de la lista y no se acepta en la entrada: el precio se fija con list_price (moneda de la lista de la tienda o currency). null en list_price_currency: el precio está en la moneda de la tienda, como antes.",
            "operations": [
                "variants.list",
                "variants.get",
                "variants.get_by_external_id",
                "variants.create",
                "variants.update",
                "variants.upsert",
                "products.list",
                "products.get",
                "products.get_by_external_id",
                "products.create",
                "products.update",
                "products.upsert"
            ]
        },
        {
            "key": "products-sale-schedule",
            "date": "2026-11-19",
            "kind": "added",
            "title": "Horario de venta del producto",
            "description": "Los productos tienen el campo sale_schedule — las franjas de la semana, en la zona horaria del comercio, en que se puede pedir el producto: una lista de {days, from, to}, donde days son días ISO (1 es lunes) y from y to son «HH:MM», con «24:00» solo como fin; una franja que termina antes de empezar pasa la medianoche y pertenece a su día de inicio. null significa que el producto se puede pedir siempre. No es la publicación: fuera de la franja el producto sigue visible y se puede agregar al carrito, y el checkout compara el horario con el momento de entrega del pedido. El campo se escribe al crear, editar y hacer upsert de un producto; null borra el horario.",
            "operations": [
                "products.list",
                "products.get",
                "products.get_by_external_id",
                "products.create",
                "products.update",
                "products.upsert"
            ]
        },
        {
            "key": "order-shipment",
            "date": "2026-11-19",
            "kind": "added",
            "title": "Envío con el transportista en el pedido",
            "description": "Los pedidos muestran su envío con el transportista: shipment — el transportista, el número y la página de seguimiento, el último estado de un conjunto cerrado y el historial de estados con el texto del transportista; previous_shipments — los envíos reemplazados por una reemisión; shipment_attempt — una emisión en curso o con resultado desconocido. La etiqueta del envío está en GET /v1/orders/{order}/shipment/label, un PDF con orders:read y customers:read porque lleva los datos del destinatario. Nuevos problemas shipment_label_unavailable y carrier_unavailable. Consultar al transportista sin un estado nuevo ya no mueve el pedido en el feed ni envía order.updated.",
            "operations": [
                "orders.list",
                "orders.get",
                "orders.get_shipment_label"
            ]
        },
        {
            "key": "order-discount-composition",
            "date": "2026-11-19",
            "kind": "added",
            "title": "Composición de los descuentos del pedido",
            "description": "Los pedidos muestran de qué se componen sus descuentos: applied_discounts — el registro de descuentos sobre los productos (de dónde viene el descuento, por qué es, nombre de la regla, código promocional, motivo del descuento manual, el ítem en una rebaja de un solo ítem, importe), delivery_discounts — los descuentos del envío, items[].discount_allocations — de qué filas del registro se compone el descuento de un ítem. Las sumas coinciden: Σ applied_discounts = discount, Σ delivery_discounts = delivery_discount, Σ de las partes de un ítem = su discount. Un descuento de la caja externa llega como una fila con source = external_pos. El pedido avanza en el feed y envía order.updated también cuando su composición cambia sin que se escriba el pedido: el registro de descuentos o el costo de los ítems.",
            "operations": [
                "orders.list",
                "orders.get"
            ]
        },
        {
            "key": "inventory-stock-documents",
            "date": "2026-11-19",
            "kind": "added",
            "title": "Traslados e inventarios",
            "description": "Bajo inventory:read aparecen los traslados entre locales (GET /v1/location-transfers) con sus líneas —variante, lote, cantidad— y los inventarios (GET /v1/stocktakes) con estado, alcance y la marca de conteo ciego. Las líneas de inventario tienen su propio feed, GET /v1/stocktake-lines: stock esperado, contado, diferencia, ajuste aplicado y stock del local después del registro; mientras un conteo ciego es borrador, el esperado y la diferencia son null. Los documentos de movimientos de stock de tipo location_transfer y stocktake ahora se leen con estos recursos. Eventos location_transfer.created, location_transfer.updated, stocktake.created, stocktake.status_changed, stocktake.updated.",
            "operations": [
                "location_transfers.list",
                "location_transfers.get",
                "stocktakes.list",
                "stocktakes.get",
                "stocktake_lines.list",
                "stocktake_lines.get"
            ]
        },
        {
            "key": "payment-rate-peg",
            "date": "2026-11-19",
            "kind": "changed",
            "title": "Vinculación de la cotización en la factura del pago",
            "description": "El modo de cotización tender.exchange_rate.mode tiene el valor pegged: la tienda vinculó la moneda del medio a otra moneda (por ejemplo, 1 USDT = 1 USD), y la cotización es la de esa moneda por el coeficiente. El campo nuevo tender.exchange_rate.peg {currency, rate} nombra la vinculación; null si la cotización no está vinculada. Los precios fijados en la moneda vinculada entran en la factura tal cual.",
            "operations": [
                "payments.list",
                "payments.get"
            ]
        },
        {
            "key": "inventory-stock-ledger",
            "date": "2026-11-19",
            "kind": "added",
            "title": "Diario de movimientos de stock y lotes",
            "description": "Con inventory:read ya están el diario de movimientos de stock (GET /v1/stock-movements) — el cambio con signo del stock físico del local, el stock posterior, el motivo, la columna del libro de existencias y el documento primario — y los lotes (GET /v1/lots) con número, vencimiento y estado. Las líneas de recepciones, devoluciones a proveedor y liquidaciones de consignación ahora traen lot_id. Eventos stock_movement.created, stock_movement.updated, lot.created, lot.updated, lot.deleted.",
            "operations": [
                "stock_movements.list",
                "stock_movements.get",
                "lots.list",
                "lots.get",
                "goods_receipts.list",
                "goods_receipts.get",
                "supplier_returns.list",
                "supplier_returns.get",
                "consignment_settlements.list",
                "consignment_settlements.get"
            ]
        },
        {
            "key": "fiscal-libro-iva-files",
            "date": "2026-11-19",
            "kind": "added",
            "title": "Libros IVA y paquete del contador como archivo",
            "description": "Las operaciones masivas suman un tercer tipo: el archivo. El tipo libro_iva.export genera los libros del Libro IVA Digital de una razón social para un mes: en params van legal_entity_id, period con formato YYYY-MM y books (ventas, compras o ambos; las compras traen los archivos de importación). El tipo accountant_package.export genera el paquete del contador. Hacen falta bulk:write y fiscal:read, el libro fiscal de Argentina en la tienda y acceso de la aplicación a todos los locales. El resultado es un ZIP con los mismos archivos que el panel; aparece completo en completed, y hasta entonces GET …/result responde con el nuevo 409 bulk_operation_result_unavailable. Una generación rechazada queda failed con el código libro_iva_not_applicable o libro_iva_incomplete; en el segundo, error.documents lista los comprobantes y los motivos.",
            "operations": [
                "bulk_operations.create",
                "bulk_operations.get_result"
            ]
        },
        {
            "key": "procurement-supplier-bills-out-of-band-payments",
            "date": "2026-11-19",
            "kind": "added",
            "title": "Pago de comprobantes de proveedor fuera del sistema",
            "description": "Nuevo scope procurement:pay: no se otorga por defecto e incluye procurement:read, pero no la escritura ni la aprobación. POST /v1/supplier-bills/{supplier_bill}/payments/out-of-band bajo If-Match marca un comprobante aprobado como pagado fuera del sistema: la deuda se cancela sin una cuenta de dinero de la tienda, y para una razón social agente de retención la lista withholdings es obligatoria. La respuesta es el pago creado, 201 con Location. DELETE /{supplier_bill}/payments/{supplier_bill_payment} bajo If-Match anula un pago con dinero o fuera del sistema junto con sus retenciones; los demás tipos los quita su propio documento: nuevo rechazo supplier_bill_payment_locked. Los pagos y las anulaciones llegan con los eventos supplier_bill_payment.created y .deleted, y el saldo pendiente del comprobante con supplier_bill.updated.",
            "operations": [
                "supplier_bills.record_out_of_band_payment",
                "supplier_bills.delete_payment"
            ]
        },
        {
            "key": "procurement-supplier-bills-approval",
            "date": "2026-11-19",
            "kind": "added",
            "title": "Aprobación de pago de comprobantes de proveedores",
            "description": "Nuevo scope procurementSaleyarove: no se otorga por defecto e incluye procurement:read, pero no la escritura. POST /v1/supplier-bills/{supplier_bill}/approve aprueba el pago de un comprobante registrado bajo If-Match: sin aprobación el comprobante no se paga, y un anticipo registrado en su orden de compra lo cancela en el acto. POST /{supplier_bill}/revoke-approval revoca la aprobación mientras el comprobante no tenga pagos. El rechazo por el estado del comprobante es supplier_bill_refused. La aprobación y su revocación llegan con el evento supplier_bill.updated y el campo approved_at.",
            "operations": [
                "supplier_bills.approve",
                "supplier_bills.revoke_approval"
            ]
        },
        {
            "key": "variants-net-content",
            "date": "2026-11-17",
            "kind": "added",
            "title": "Contenido neto de la unidad de la variante",
            "description": "Las variantes tienen el campo net_content — contenido neto de una unidad {quantity, unit}: paquete de 500 g, botella de 1000 ml. La respuesta trae la medida vigente: un pack de varias unidades de otra variante la toma de ella, una unidad envasada, de su propia medida. Se puede escribir al crear o editar una variante y un producto con variantes — solo en una variante común por unidad; null la borra. Con ella un combo cuenta paquetes en una posición «desde 1 kg» y los feeds de vitrina muestran el precio por kilo.",
            "operations": [
                "variants.list",
                "variants.get",
                "variants.get_by_external_id",
                "variants.create",
                "variants.update",
                "variants.upsert",
                "products.list",
                "products.get",
                "products.get_by_external_id",
                "products.create",
                "products.update",
                "products.upsert"
            ]
        },
        {
            "key": "procurement-supplier-bills-write",
            "date": "2026-11-16",
            "kind": "added",
            "title": "Escritura de comprobantes de proveedores",
            "description": "Con procurement:write: el borrador de comprobante de proveedor (POST /v1/supplier-bills), los cambios del borrador con If-Match (PATCH /v1/supplier-bills/{supplier_bill}), la eliminación del borrador (DELETE), el registro con POST /{supplier_bill}/post y la anulación con POST /{supplier_bill}/void. Los campos son los de la respuesta: el período fiscal como YYYY-MM, la cotización como texto, los impuestos además del IVA en additional_taxes, los datos de ARCA en ar. La respuesta y la entrada suman ar.import, los datos de una importación de bienes o servicios. El registro puede pedir el consentimiento vendor_tax_id o close_returns. Nuevo rechazo supplier_bill_refused: el comando no corresponde al estado del comprobante.",
            "operations": [
                "supplier_bills.create",
                "supplier_bills.update",
                "supplier_bills.delete",
                "supplier_bills.post",
                "supplier_bills.void"
            ]
        },
        {
            "key": "procurement-purchase-orders-write",
            "date": "2026-11-16",
            "kind": "added",
            "title": "Escritura de órdenes de compra",
            "description": "Con procurement:write: el borrador de orden de compra (POST /v1/purchase-orders), los cambios con If-Match (PATCH /v1/purchase-orders/{purchase_order}) — el borrador entero; de la orden colocada, las líneas, la fecha y la nota con revisión y mensaje al proveedor —, el borrado del borrador (DELETE) y las transiciones POST /{purchase_order}/place, /cancel y /close. La cantidad y la unidad de precio de la línea van como texto en la unidad base de la variante, igual que en la respuesta. Funciona en tiendas con compras activadas; si no, 403 capability_disabled. Nuevo error purchase_order_refused: el comando no corresponde al estado de la orden.",
            "operations": [
                "purchase_orders.create",
                "purchase_orders.update",
                "purchase_orders.delete",
                "purchase_orders.place",
                "purchase_orders.cancel",
                "purchase_orders.close"
            ]
        },
        {
            "key": "kitchen-modifiers",
            "date": "2026-11-16",
            "kind": "added",
            "title": "Modificadores",
            "description": "Grupos de modificadores con opciones bajo catalog:read y catalog:write: el feed GET /v1/modifier-groups, un grupo por ID y por el ID de tu sistema, crear, modificar con If-Match, el upsert PATCH /v1/modifier-groups/by-external-id/{external_id} y archivar con el consentimiento modifier_group_archive. Las opciones son el conjunto del grupo: una fila encuentra su opción por id o external_id; una opción que falta en el conjunto se archiva. Una modificación que baja el mínimo de elección de productos pide el consentimiento modifier_product_minimum. GET y PUT /v1/products/{product}/modifier-groups leen y reemplazan los grupos del producto con la regla de elección y los recargos de opciones por variante; la ficha del producto tiene el nuevo campo modifier_groups. La receta de la variante tiene el nuevo campo option_recipes — las cantidades de opciones por plato. El tope de grupos de la tienda es record_limit_reached.",
            "operations": [
                "modifier_groups.list",
                "modifier_groups.get",
                "modifier_groups.get_by_external_id",
                "modifier_groups.create",
                "modifier_groups.update",
                "modifier_groups.upsert",
                "modifier_groups.delete",
                "products.list",
                "products.get",
                "products.get_by_external_id",
                "products.create",
                "products.update",
                "products.upsert",
                "products.replace_options",
                "products.get_modifier_groups",
                "products.replace_modifier_groups",
                "variants.get_recipe",
                "variants.replace_recipe"
            ]
        },
        {
            "key": "procurement-suppliers-write",
            "date": "2026-11-16",
            "kind": "added",
            "title": "Escritura de proveedores",
            "description": "Nuevo scope procurement:write. Crear un proveedor (POST /v1/suppliers), actualizarlo bajo If-Match (PATCH /v1/suppliers/{supplier}) y crearlo o actualizarlo por su ID en tu sistema (PATCH /v1/suppliers/by-external-id/{external_id}); buscar un proveedor por ese ID con GET /v1/suppliers/by-external-id/{external_id} bajo procurement:read. Se escriben los mismos campos que llegan en la respuesta, salvo customer_id. Los proveedores tienen el campo external_id. Nuevo error record_limit_reached: la tienda alcanzó el tope de registros de este tipo, que no depende del plan; lo devuelven POST /v1/suppliers y POST /v1/recommendation-rules.",
            "operations": [
                "suppliers.list",
                "suppliers.get",
                "suppliers.get_by_external_id",
                "suppliers.create",
                "suppliers.update",
                "suppliers.upsert",
                "recommendation_rules.create",
                "events.list"
            ]
        },
        {
            "key": "kitchen-catalog",
            "date": "2026-11-16",
            "kind": "added",
            "title": "Insumos, preelaborados y recetas",
            "description": "POST /v1/products y el upsert crean insumos y preelaborados (type ingredient, prep) con stock_unit — la unidad base del stock y de las recetas y el envase de compra; cada respuesta de producto trae stock_unit. GET y PUT /v1/variants/{variant}/recipe leen y reemplazan la receta de una variante: componentes con la cantidad en la unidad de cada componente y el rendimiento del preelaborado, bajo la versión del producto. La mano de obra, los pasos de producción, el método de descuento y los subproductos quedan en el panel de la tienda: la API no los toca.",
            "operations": [
                "products.list",
                "products.get",
                "products.get_by_external_id",
                "products.create",
                "products.update",
                "products.upsert",
                "products.replace_options",
                "variants.get_recipe",
                "variants.replace_recipe"
            ]
        },
        {
            "key": "tax-withholdings",
            "date": "2026-11-16",
            "kind": "added",
            "title": "Retenciones y percepciones",
            "description": "Con fiscal:read: el registro de retenciones y percepciones (GET /v1/tax-withholdings, filtro direction): el impuesto que le retuvieron a la tienda (suffered: proveedor de cobros, banco, cliente agente de retención) y el que retuvo la tienda al pagarle a un proveedor (practiced): tipo, impuesto y jurisdicción, importe, base y alícuota, contraparte, impuesto y mes de cómputo, número de certificado, origen y anulación. El certificado que la tienda le entrega a la contraparte es GET /v1/tax-withholdings/{tax_withholding}/certificate (PDF). Los movimientos de cuenta corriente de tipo withholding tienen tax_withholding_id: el certificado en el registro. Eventos nuevos: tax_withholding.created, tax_withholding.updated, tax_withholding.annulled y tax_withholding.deleted.",
            "operations": [
                "tax_withholdings.list",
                "tax_withholdings.get",
                "tax_withholdings.get_certificate",
                "customer_account_entries.list",
                "customer_account_entries.get",
                "events.list",
                "webhook_endpoints.create",
                "webhook_endpoints.update"
            ]
        },
        {
            "key": "consignment-settlements",
            "date": "2026-11-15",
            "kind": "added",
            "title": "Liquidaciones de consignación",
            "description": "Con procurement:read: liquidaciones de consignación (GET /v1/consignment-settlements, filtro supplier_id): lo vendido de la mercadería en consignación en un período, lo dado de baja a cargo de la tienda y la diferencia por un precio corregido en la recepción; subtotales por sección y líneas con la variante, la recepción, la cantidad en la unidad base de la variante y el precio de compra, en la moneda de la liquidación y en la de la tienda. Los comprobantes de proveedores ya apuntan a la liquidación con consignment_settlement_id. Eventos nuevos: consignment_settlement.created, consignment_settlement.updated, consignment_settlement.posted y consignment_settlement.voided.",
            "operations": [
                "consignment_settlements.list",
                "consignment_settlements.get",
                "events.list",
                "webhook_endpoints.create",
                "webhook_endpoints.update"
            ]
        },
        {
            "key": "procurement-documents",
            "date": "2026-11-15",
            "kind": "added",
            "title": "Órdenes de compra, recepciones y devoluciones a proveedores",
            "description": "Con procurement:read: órdenes de compra (GET /v1/purchase-orders, filtro supplier_id) con líneas de cantidad pedida, confirmada por el proveedor y recibida; recepciones (GET /v1/goods-receipts, filtros supplier_id y purchase_order_id) con líneas que llevan el precio del remito, el precio en la moneda de la tienda y el costo después del impuesto, y correcciones de antes y después; devoluciones a proveedores (GET /v1/supplier-returns, filtros supplier_id y goods_receipt_id) con líneas, la compensación esperada y la recibida y correcciones. Las cantidades son texto en la unidad base de la variante. Los comprobantes de proveedores sumaron goods_receipt_ids, purchase_order_ids y supplier_return_ids. Eventos nuevos: purchase_order.created, purchase_order.updated, purchase_order.status_changed, purchase_order.deleted, goods_receipt.created, goods_receipt.updated, goods_receipt.voided, supplier_return.created, supplier_return.updated, supplier_return.status_changed y supplier_return.deleted.",
            "operations": [
                "purchase_orders.list",
                "purchase_orders.get",
                "goods_receipts.list",
                "goods_receipts.get",
                "supplier_returns.list",
                "supplier_returns.get",
                "supplier_bills.list",
                "supplier_bills.get",
                "events.list",
                "webhook_endpoints.create",
                "webhook_endpoints.update"
            ]
        },
        {
            "key": "procurement-settlements",
            "date": "2026-11-15",
            "kind": "added",
            "title": "Saldos, conciliación y compensaciones",
            "description": "Con procurement:read: saldo del proveedor (GET /v1/suppliers/{id}/balance) con los siete componentes de la deuda, la apertura por vencimiento y el total; conciliación de saldos (GET /v1/suppliers/{id}/statement) con saldo inicial y final del período y líneas con saldo acumulado; ambos aceptan legal_entity_id. Compensaciones (GET /v1/settlement-offsets), sus líneas en un feed aparte (GET /v1/settlement-offset-lines) y acuerdos de compensación (GET /v1/settlement-agreements). Los comprobantes de proveedores suman paid_total y outstanding en la moneda del documento. Los movimientos de cuentas corrientes suman settlement_offset_id. El customer_id del proveedor ahora requiere customers:read. Eventos nuevos: settlement_agreement.created, settlement_agreement.updated, settlement_agreement.deleted, settlement_offset.created, settlement_offset.updated y settlement_offset.voided.",
            "operations": [
                "suppliers.get_balance",
                "suppliers.get_statement",
                "suppliers.list",
                "suppliers.get",
                "settlement_agreements.list",
                "settlement_agreements.get",
                "settlement_offsets.list",
                "settlement_offsets.get",
                "settlement_offset_lines.list",
                "settlement_offset_lines.get",
                "supplier_bills.list",
                "supplier_bills.get",
                "customer_account_entries.list",
                "customer_account_entries.get",
                "events.list",
                "webhook_endpoints.create",
                "webhook_endpoints.update"
            ]
        },
        {
            "key": "procurement-payables",
            "date": "2026-11-15",
            "kind": "added",
            "title": "Proveedores y comprobantes de proveedores",
            "description": "Nuevo scope procurement:read. Proveedores (GET /v1/suppliers): datos fiscales y condiciones de pago, sin persona de contacto ni notas. Comprobantes de proveedores (GET /v1/supplier-bills, filtro supplier_id): facturas, notas y deudas por entregas sin factura (fiscal: false), con el IVA como línea de impuesto común, percepciones y retenciones en la lista additional_taxes, líneas y datos de ARCA en ar. Pagos de comprobantes (GET /v1/supplier-bill-payments, filtro supplier_bill_id): con dinero, compensación, nota de crédito, anticipo de una orden de compra, gasto del libro o fuera del sistema. Nuevos eventos: supplier.created, supplier.updated, supplier.deleted, supplier_bill.created, supplier_bill.updated, supplier_bill.posted, supplier_bill.voided, supplier_bill.deleted, supplier_bill_payment.created, supplier_bill_payment.updated y supplier_bill_payment.deleted.",
            "operations": [
                "suppliers.list",
                "suppliers.get",
                "supplier_bills.list",
                "supplier_bills.get",
                "supplier_bill_payments.list",
                "supplier_bill_payments.get",
                "events.list",
                "webhook_endpoints.create",
                "webhook_endpoints.update"
            ]
        },
        {
            "key": "money-write",
            "date": "2026-11-15",
            "kind": "added",
            "title": "Escritura del libro de dinero y cobros de cuentas corrientes",
            "description": "Nuevo scope finance:write. Ingreso o egreso manual (POST /v1/money-transactions), edición y baja de un movimiento con If-Match: en un movimiento con documento de origen cambian solo la categoría, la contraparte y la descripción, lo demás da 409 money_transaction_locked. Los importes en la moneda de la cuenta van como cadena decimal y los decimales de más dan 422. Transferencias entre cuentas: POST, GET, PATCH y DELETE /v1/money-transfers. Las operaciones masivas money_transactions.create y money_transactions.update asientan y categorizan el libro en lote. Cobro de una cuenta corriente con dinero ya recibido: POST /v1/customer-accounts/{customer_account}/payments, con certificados de retención. Las entradas de cuentas corrientes suman el filtro order_id: las del cobro se vinculan con el pedido de cobro, no con un pago.",
            "operations": [
                "money_transactions.create",
                "money_transactions.update",
                "money_transactions.delete",
                "money_transfers.create",
                "money_transfers.get",
                "money_transfers.update",
                "money_transfers.delete",
                "customer_accounts.record_payment",
                "customer_account_entries.list",
                "bulk_operations.create",
                "bulk_operations.list",
                "bulk_operations.get"
            ]
        },
        {
            "key": "customer-accounts",
            "date": "2026-11-15",
            "kind": "added",
            "title": "Cuentas corrientes de clientes",
            "description": "Con finance:read ya están las cuentas corrientes de clientes (GET /v1/customer-accounts) con su saldo, igual a la suma de sus movimientos, el límite de crédito (null: sin límite) y el plazo de pago; los movimientos de las cuentas (GET /v1/customer-account-entries, filtros customer_account_id y payment_id) con importe con signo, vencimiento de cada cargo y vínculos con el pedido, el pago y la devolución; y el resumen de un período (GET /v1/customer-accounts/{customer_account}/statement) con saldo acumulado y deudas abiertas con vencimiento. El customer_id y la nota del personal sobre el cliente piden customers:read. Eventos nuevos: customer_account.created, customer_account.updated, customer_account_entry.created y customer_account_entry.updated, que llega cuando la unión de clientes pasa un movimiento a la cuenta del cliente que queda.",
            "operations": [
                "customer_accounts.list",
                "customer_accounts.get",
                "customer_accounts.get_statement",
                "customer_account_entries.list",
                "customer_account_entries.get",
                "events.list",
                "webhook_endpoints.create",
                "webhook_endpoints.update"
            ]
        },
        {
            "key": "gift-cards",
            "date": "2026-11-15",
            "kind": "added",
            "title": "Tarjetas de regalo y sus movimientos",
            "description": "Con finance:read ya están las tarjetas de regalo (GET /v1/gift-cards) con valor nominal, saldo y outstanding, la deuda de la tienda por la tarjeta: 0 si no está pagada, igual al saldo si está bloqueada o vencida; y los movimientos de tarjetas (GET /v1/gift-card-transactions, filtros gift_card_id y payment_id) con importe con signo y saldo después de cada uno. El titular customer_id requiere customers:read. Eventos nuevos: gift_card.created, gift_card.updated y gift_card_transaction.created.",
            "operations": [
                "gift_cards.list",
                "gift_cards.get",
                "gift_card_transactions.list",
                "gift_card_transactions.get",
                "events.list",
                "webhook_endpoints.create",
                "webhook_endpoints.update"
            ]
        },
        {
            "key": "pos-shifts",
            "date": "2026-11-15",
            "kind": "added",
            "title": "Turnos de caja y diario del cajón",
            "description": "finance:read ahora abre los turnos de caja (GET /v1/pos-shifts) con el arqueo del cajón en cada moneda — fondo inicial, esperado, contado, diferencia y fondo que queda para el turno siguiente —, el diario del cajón (GET /v1/pos-cash-movements, filtro shift_id) y los motivos de ingreso y retiro (GET /v1/pos-cash-reasons). Pagos y devoluciones suman el campo y el filtro pos_shift_id: el turno que recibió el dinero, para conciliar sus ventas. Eventos nuevos: pos_shift.opened, pos_shift.closed, pos_shift.updated y pos_cash_movement.created.",
            "operations": [
                "pos_shifts.list",
                "pos_shifts.get",
                "pos_cash_movements.list",
                "pos_cash_movements.get",
                "pos_cash_reasons.list",
                "payments.list",
                "payments.get",
                "payments.confirm",
                "refunds.list",
                "refunds.get",
                "refunds.create",
                "refunds.confirm",
                "events.list",
                "webhook_endpoints.create",
                "webhook_endpoints.update"
            ]
        },
        {
            "key": "exchange-rates",
            "date": "2026-11-14",
            "kind": "added",
            "title": "Cotización contable del día",
            "description": "La nueva operación GET /v1/exchange-rates/{currency} con finance:read devuelve la cotización contable del día en una fecha — la que usa el libro de dinero para convertir a la moneda de la tienda los movimientos de una cuenta en esa moneda: como cadena decimal, con el día en que se fijó (rate_date) y la fuente de cotización de mercado de la regla de la tienda.",
            "operations": [
                "exchange_rates.get"
            ]
        },
        {
            "key": "money-journal",
            "date": "2026-11-14",
            "kind": "added",
            "title": "Libro de dinero: cuentas, categorías y movimientos",
            "description": "El nuevo scope finance:read abre las cuentas de dinero de la tienda con su saldo en la moneda de la cuenta, las categorías de movimientos con los códigos de las categorías del sistema y el libro de movimientos — con el importe del asiento en la moneda de la tienda y en la de la cuenta, la fecha contable, el registro que lo asentó (source) y el comprobante principal (document); las patas de una transferencia comparten transfer_id. Eventos nuevos: money_transaction.created, money_transaction.updated y money_transaction.deleted.",
            "operations": [
                "money_accounts.list",
                "money_accounts.get",
                "money_categories.list",
                "money_transactions.list",
                "money_transactions.get",
                "events.list",
                "webhook_endpoints.create",
                "webhook_endpoints.update"
            ]
        },
        {
            "key": "payment-provider-charges",
            "date": "2026-11-14",
            "kind": "added",
            "title": "Comisión del proveedor e impuesto retenido del pago",
            "description": "El pago suma provider_fee_amount y provider_withheld_tax_amount — la comisión del proveedor de pagos y el impuesto que retuvo como agente — y las partes que el proveedor devolvió al reembolsar al comprador: refunded_provider_fee_amount y refunded_provider_withheld_tax_amount.",
            "operations": [
                "payments.list",
                "payments.get",
                "payments.confirm",
                "events.list",
                "webhook_endpoints.create",
                "webhook_endpoints.update"
            ]
        },
        {
            "key": "payment-money",
            "date": "2026-11-14",
            "kind": "added",
            "title": "Dinero del pago, razón social de la venta y eventos de pagos y reembolsos",
            "description": "El pago suma tender — el pago en moneda extranjera con la cotización, su modo, fuente, base de mercado y recargo de la tienda —, received_asset (la moneda que llegó de verdad) y legal_entity_id; el pedido suma legal_entity_id. Eventos nuevos: payment.created, payment.succeeded, payment.status_changed, payment.updated, refund.completed, refund.status_changed y refund.updated.",
            "operations": [
                "payments.list",
                "payments.get",
                "payments.confirm",
                "orders.list",
                "orders.get",
                "orders.cancel",
                "orders.set_status",
                "draft_orders.complete",
                "bulk_operations.get_result",
                "events.list",
                "webhook_endpoints.create",
                "webhook_endpoints.update"
            ]
        },
        {
            "key": "fiscal-records",
            "date": "2026-11-14",
            "kind": "added",
            "title": "Razones sociales, comprobantes fiscales y períodos fiscales",
            "description": "El nuevo scope fiscal:read abre las razones sociales de la tienda, los comprobantes fiscales en todos los estados —con los impuestos autorizados por el fisco, la fecha contable, los datos de ARCA y el PDF— y los períodos fiscales de las razones sociales en tiendas de Argentina. El receptor del comprobante requiere customers:read. Eventos nuevos: fiscal_document.created, fiscal_document.updated, fiscal_document.issued, fiscal_document.failed, fiscal_document.annulled y tax_period.status_changed.",
            "operations": [
                "legal_entities.list",
                "fiscal_documents.list",
                "fiscal_documents.get",
                "fiscal_documents.get_pdf",
                "tax_periods.list",
                "events.list",
                "webhook_endpoints.create",
                "webhook_endpoints.update"
            ]
        },
        {
            "key": "sale-taxes",
            "date": "2026-11-13",
            "kind": "added",
            "title": "Impuesto de la venta y costo de los ítems de pedidos",
            "description": "Los pedidos reciben tax_lines, delivery_tax_lines y tax_lines de cada ítem, y las devoluciones reciben tax_lines: el impuesto de la venta según la clasificación de los productos, en una forma TaxLine común. Con costs:read, los ítems de los pedidos reciben cost_amount y cost_basis.",
            "operations": [
                "orders.list",
                "orders.get",
                "orders.cancel",
                "orders.set_status",
                "draft_orders.complete",
                "refunds.list",
                "refunds.get",
                "refunds.create",
                "refunds.confirm",
                "bulk_operations.get_result"
            ]
        },
        {
            "key": "tax-classes",
            "date": "2026-11-13",
            "kind": "added",
            "title": "Clases de impuesto de los productos",
            "description": "El nuevo endpoint /v1/tax-classes lista las clases de impuesto de la tienda: el tipo de impuesto (taxed, exempt, untaxed) y la alícuota en puntos básicos. Los productos tienen un nuevo campo tax_class_id, de lectura y escritura al crear, modificar y en el upsert; null es la clase predeterminada de la tienda. Antes, un producto creado por la API siempre recibía la clase predeterminada.",
            "operations": [
                "tax_classes.list",
                "products.list",
                "products.get",
                "products.get_by_external_id",
                "products.create",
                "products.update",
                "products.upsert",
                "products.replace_options"
            ]
        },
        {
            "key": "customer-marketing-consents-by-channel",
            "date": "2026-11-13",
            "kind": "added",
            "title": "Consentimiento de publicidad por canal",
            "description": "El cliente tiene un campo nuevo marketing_consents — consentimiento de publicidad por canal (email, telegram, whatsapp, instagram): una fila por cada canal donde el cliente aceptó (subscribed) o rechazó (unsubscribed) de forma explícita, con el momento del último consentimiento explícito. Un rechazo en un canal ya no detiene la publicidad en los demás. Por WhatsApp la tienda envía publicidad solo con subscribed, en cualquier modo de consentimiento.",
            "operations": [
                "customers.list",
                "customers.get",
                "customers.get_by_external_id",
                "customers.create",
                "customers.update",
                "customers.upsert"
            ]
        },
        {
            "key": "customer-accepts-marketing-deprecated",
            "date": "2026-11-13",
            "kind": "deprecated",
            "title": "accepts_marketing y marketing_consent_at están obsoletos",
            "description": "Los campos del cliente accepts_marketing y marketing_consent_at están obsoletos y ahora indican el consentimiento de publicidad por email. El consentimiento por canal está en marketing_consents. Los campos siguen funcionando mientras funcione /v1.",
            "operations": [
                "customers.list",
                "customers.get",
                "customers.get_by_external_id",
                "customers.create",
                "customers.update",
                "customers.upsert"
            ]
        },
        {
            "key": "membership-renewal-void",
            "date": "2026-11-13",
            "kind": "added",
            "title": "Factura de renovación de membresía",
            "description": "Los pedidos tienen un nuevo motivo de cancelación del sistema cancel_reason = membership_renewal_void: se anuló la factura de renovación de una membresía porque se canceló o terminó sin pago. Esa factura no tenía dinero cobrado.",
            "operations": [
                "orders.list",
                "orders.get"
            ]
        },
        {
            "key": "draft-order-currency",
            "date": "2026-11-13",
            "kind": "added",
            "title": "Moneda del total al confirmar un borrador",
            "description": "Confirmar un borrador acepta el campo opcional currency: la moneda en la que la app leyó el total. Una tienda sin pedidos puede cambiar de moneda, y el total coincidiría como número en otra moneda; ahora esa confirmación recibe 422 y no se crea el pedido.",
            "operations": [
                "draft_orders.complete"
            ]
        },
        {
            "key": "service-package-expiry",
            "date": "2026-11-13",
            "kind": "added",
            "title": "Vencimiento de paquetes de visitas",
            "description": "Las visitas de un paquete vencido pasan a ser una venta del día: un pedido pagado con el método service_package. Extender el plazo cancela esa venta por sistema: el pedido recibe el motivo de cancelación service_package_term_extended y las visitas vuelven al paquete.",
            "operations": [
                "orders.list",
                "orders.get"
            ]
        },
        {
            "key": "operation-problem-types",
            "date": "2026-11-12",
            "kind": "added",
            "title": "Tipos de error de cada endpoint",
            "description": "Cada endpoint de la especificación tiene ahora el campo x-problem-types con los tipos de error que devuelve: sus errores propios y los que se desprenden de cómo funciona (clave de idempotencia, versión en If-Match, cursor del feed, rango del resultado, eliminación, consentimiento de las consecuencias). Los errores comunes, como token, acceso, validación de la entrada, límite de solicitudes y fallas del servidor, pueden venir de cualquier endpoint, y el catálogo x-problem-types del documento los sigue listando. Se quitó del catálogo el tipo stocktake_location_occupied porque ningún endpoint lo devolvía. Los endpoints que responden con un conflicto sin clave de idempotencia ahora describen la respuesta 409.",
            "operations": []
        },
        {
            "key": "rejected-requests-limit",
            "date": "2026-11-12",
            "kind": "changed",
            "title": "Límite de solicitudes rechazadas",
            "description": "Las solicitudes rechazadas en la entrada — 401 y 403 de una dirección no permitida o de un plan sin API — ahora se cuentan por dirección. Por encima del límite rejected_requests_per_minute la dirección recibe 429 too_many_requests con policy igual a rejected y el encabezado Retry-After hasta que termine el minuto. Las solicitudes con un token vigente no se cuentan y este límite nunca las rechaza.",
            "operations": []
        },
        {
            "key": "service-package-redemption",
            "date": "2026-11-12",
            "kind": "added",
            "title": "Visitas de paquetes",
            "description": "Medio de pago service_package: una visita descontada del paquete de visitas del cliente; la línea del pedido la pagó una visita comprada antes con el paquete. El negocio cobró ese dinero al vender el paquete, así que este pago no entra en la caja ni en las cuentas, y la visita pasa a ser ingreso del pedido ahora. Devolver esa línea devuelve la visita al paquete: una transacción de devolución con destino service_package que no mueve dinero.",
            "operations": [
                "payments.list",
                "payments.get",
                "refunds.list",
                "refunds.get",
                "refunds.create",
                "refunds.calculate",
                "orders.list",
                "orders.get",
                "draft_orders.complete"
            ]
        },
        {
            "key": "service-packages",
            "date": "2026-11-12",
            "kind": "added",
            "title": "Paquetes de visitas",
            "description": "Tipo de producto service_package: un paquete de visitas, un conjunto de visitas a servicios que la tienda vende por adelantado. Los pedidos tienen el campo service_package_issue_amount: el total de paquetes vendidos en el pedido. Un paquete es una obligación de la tienda en visitas, no un ingreso: el ingreso llega cuando se usa una visita del paquete. Restá el campo del total junto con gift_card_issue_amount, reservation_deposit_amount y account_payment_amount.",
            "operations": [
                "orders.list",
                "orders.get",
                "orders.set_status",
                "orders.cancel",
                "draft_orders.complete",
                "bulk_operations.get_result",
                "products.list",
                "products.create",
                "products.get",
                "products.update",
                "products.get_by_external_id",
                "products.upsert",
                "products.replace_options"
            ]
        },
        {
            "key": "v1",
            "date": "2026-11-11",
            "kind": "released",
            "title": "API de integraciones v1",
            "description": "La primera versión del contrato: la tienda y sus locales, el catálogo, el stock, los pedidos y sus estados, los borradores de pedido, los pagos y reembolsos, los clientes, las cargas y operaciones masivas, los eventos y los webhooks. Cada cambio posterior del contrato aparece en este registro.",
            "operations": []
        }
    ],
    "paths": {
        "/bulk-operations": {
            "get": {
                "operationId": "bulk_operations.list",
                "summary": "Listar las operaciones masivas de la app cambiadas desde un momento dado: avance y resultados",
                "tags": [
                    "BulkOperations"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Tamaño de página: hasta 250 registros; 50 por defecto."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Cursor opaco: next_cursor de la página anterior, o sync_cursor de la última página guardado por la sincronización anterior. El listado va en orden de confirmación, así que el cursor de sincronización devuelve luego solo lo que cambió después de él."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Solo los registros cambiados después de este momento, ISO 8601 con zona horaria. Un filtro de la primera sincronización; después se sigue con el cursor."
                    },
                    {
                        "name": "type",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "enum": [
                                "inventory.set",
                                "products.upsert",
                                "money_transactions.create",
                                "money_transactions.update",
                                "orders.export",
                                "libro_iva.export",
                                "accountant_package.export"
                            ]
                        },
                        "description": "Solo las operaciones de este tipo."
                    },
                    {
                        "name": "status",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "enum": [
                                "pending",
                                "running",
                                "cancelling",
                                "completed",
                                "cancelled",
                                "failed"
                            ]
                        },
                        "description": "Solo las operaciones en este estado."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "bulk:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/BulkOperation"
                                            },
                                            "description": "Registros de la página."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID del registro borrado."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Cuándo se borró el registro."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Registros borrados de la base desde el cursor, como marcas de eliminación: solo con include_deleted=true en la continuación por el cursor de sincronización."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Cursor de la página siguiente; null en la última."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true si hay una página siguiente."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "En la última página — el cursor desde el que continuar más tarde: con él llega solo lo que cambió después de esta página. null en las demás."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            },
            "post": {
                "operationId": "bulk_operations.create",
                "summary": "Iniciar una operación masiva desde una carga o una dirección de entrada, una exportación del listado o la generación de un archivo",
                "tags": [
                    "BulkOperations"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/CreateBulkOperationRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "bulk:write"
                        ]
                    }
                ],
                "responses": {
                    "202": {
                        "description": "Aceptado: el resultado está en la dirección de Location",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "Location": {
                                "$ref": "#/components/headers/Location"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/BulkOperation"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "capability_disabled",
                    "bulk_operation_queue_full",
                    "idempotency_key_in_use",
                    "idempotency_key_reused",
                    "invalid_idempotency_key"
                ]
            }
        },
        "/bulk-operations/{operation}": {
            "get": {
                "operationId": "bulk_operations.get",
                "summary": "Obtener una operación masiva",
                "tags": [
                    "BulkOperations"
                ],
                "parameters": [
                    {
                        "name": "operation",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID de la operación masiva."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "bulk:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/BulkOperation"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            }
        },
        "/bulk-operations/{operation}/result": {
            "get": {
                "operationId": "bulk_operations.get_result",
                "summary": "Obtener el resultado de una operación masiva: NDJSON, una línea por línea de entrada o por elemento exportado, o el ZIP de una operación de archivo; se reanuda con Range",
                "tags": [
                    "BulkOperations"
                ],
                "parameters": [
                    {
                        "name": "operation",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID de la operación masiva."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/Range"
                    },
                    {
                        "$ref": "#/components/parameters/IfRange"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "bulk:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Accept-Ranges": {
                                "$ref": "#/components/headers/AcceptRanges"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ResultETag"
                            }
                        },
                        "content": {
                            "application/x-ndjson": {
                                "schema": {
                                    "anyOf": [
                                        {
                                            "type": "object",
                                            "properties": {
                                                "line": {
                                                    "type": "integer",
                                                    "description": "Número de la línea de la entrada, desde 1."
                                                },
                                                "status": {
                                                    "type": "integer",
                                                    "description": "Estado HTTP que la línea obtendría como solicitud separada."
                                                },
                                                "body": {
                                                    "type": "object",
                                                    "additionalProperties": true,
                                                    "description": "Respuesta a la línea: el registro tal como lo devuelve su endpoint, o un rechazo problem+json."
                                                }
                                            },
                                            "required": [
                                                "line",
                                                "status",
                                                "body"
                                            ]
                                        },
                                        {
                                            "$ref": "#/components/schemas/Order"
                                        }
                                    ]
                                }
                            },
                            "application/zip": {
                                "schema": {
                                    "type": "string",
                                    "format": "binary"
                                }
                            }
                        }
                    },
                    "206": {
                        "description": "Parte del resultado por Range",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Accept-Ranges": {
                                "$ref": "#/components/headers/AcceptRanges"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ResultETag"
                            },
                            "Content-Range": {
                                "$ref": "#/components/headers/ContentRange"
                            }
                        },
                        "content": {
                            "application/x-ndjson": {
                                "schema": {
                                    "anyOf": [
                                        {
                                            "type": "object",
                                            "properties": {
                                                "line": {
                                                    "type": "integer",
                                                    "description": "Número de la línea de la entrada, desde 1."
                                                },
                                                "status": {
                                                    "type": "integer",
                                                    "description": "Estado HTTP que la línea obtendría como solicitud separada."
                                                },
                                                "body": {
                                                    "type": "object",
                                                    "additionalProperties": true,
                                                    "description": "Respuesta a la línea: el registro tal como lo devuelve su endpoint, o un rechazo problem+json."
                                                }
                                            },
                                            "required": [
                                                "line",
                                                "status",
                                                "body"
                                            ]
                                        },
                                        {
                                            "$ref": "#/components/schemas/Order"
                                        }
                                    ]
                                }
                            },
                            "application/zip": {
                                "schema": {
                                    "type": "string",
                                    "format": "binary"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "416": {
                        "$ref": "#/components/responses/RangeNotSatisfiable"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "bulk_operation_result_unavailable",
                    "range_not_satisfiable"
                ]
            }
        },
        "/bulk-operations/{operation}/cancel": {
            "post": {
                "operationId": "bulk_operations.cancel",
                "summary": "Cancelar una operación masiva en el límite de una línea",
                "tags": [
                    "BulkOperations"
                ],
                "parameters": [
                    {
                        "name": "operation",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID de la operación masiva."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "bulk:write"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/BulkOperation"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "bulk_operation_finished",
                    "idempotency_key_in_use",
                    "idempotency_key_reused",
                    "invalid_idempotency_key"
                ]
            }
        },
        "/categories": {
            "get": {
                "operationId": "categories.list",
                "summary": "Listar las categorías del catálogo cambiadas desde un momento dado",
                "tags": [
                    "Categories"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Tamaño de página: hasta 250 registros; 50 por defecto."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Cursor opaco: next_cursor de la página anterior, o sync_cursor de la última página guardado por la sincronización anterior. El listado va en orden de confirmación, así que el cursor de sincronización devuelve luego solo lo que cambió después de él."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Solo los registros cambiados después de este momento, ISO 8601 con zona horaria. Un filtro de la primera sincronización; después se sigue con el cursor."
                    },
                    {
                        "name": "include_deleted",
                        "in": "query",
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "true — devolver también los registros eliminados: los archivados con deleted_at y los borrados de la base como marcas de eliminación {id, deleted_at} en la continuación por el cursor de sincronización. Activalo para sincronizar."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "catalog:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/Category"
                                            },
                                            "description": "Registros de la página."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID del registro borrado."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Cuándo se borró el registro."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Registros borrados de la base desde el cursor, como marcas de eliminación: solo con include_deleted=true en la continuación por el cursor de sincronización."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Cursor de la página siguiente; null en la última."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true si hay una página siguiente."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "En la última página — el cursor desde el que continuar más tarde: con él llega solo lo que cambió después de esta página. null en las demás."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            },
            "post": {
                "operationId": "categories.create",
                "summary": "Crear una categoría del catálogo",
                "tags": [
                    "Categories"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/CreateCategoryRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "catalog:write"
                        ]
                    }
                ],
                "responses": {
                    "201": {
                        "description": "Creado",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            },
                            "Location": {
                                "$ref": "#/components/headers/Location"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Category"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "external_id_archived",
                    "external_id_in_use",
                    "idempotency_key_in_use",
                    "plan_limit_reached",
                    "idempotency_key_reused",
                    "invalid_idempotency_key"
                ]
            }
        },
        "/categories/{category}": {
            "get": {
                "operationId": "categories.get",
                "summary": "Obtener una categoría del catálogo",
                "tags": [
                    "Categories"
                ],
                "parameters": [
                    {
                        "name": "category",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID de la categoría."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "catalog:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Category"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            },
            "patch": {
                "operationId": "categories.update",
                "summary": "Cambiar una categoría del catálogo",
                "tags": [
                    "Categories"
                ],
                "parameters": [
                    {
                        "name": "category",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID de la categoría."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatch"
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/UpdateCategoryRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "catalog:write"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Category"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "external_id_archived",
                    "external_id_in_use",
                    "idempotency_key_in_use",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            },
            "delete": {
                "operationId": "categories.delete",
                "summary": "Archivar una categoría del catálogo",
                "tags": [
                    "Categories"
                ],
                "parameters": [
                    {
                        "name": "category",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID de la categoría."
                    },
                    {
                        "name": "consent",
                        "in": "query",
                        "description": "Consentimientos a las consecuencias del cambio, por tipo: consent[<consent_kind>]=<consent_token> de una respuesta 409 consent_required. Conservá los consentimientos ya dados cuando se pide el tipo siguiente.",
                        "style": "deepObject",
                        "explode": true,
                        "schema": {
                            "type": "object",
                            "properties": {
                                "category_archive": {
                                    "type": "string",
                                    "minLength": 64,
                                    "maxLength": 64,
                                    "description": "Archivar la categoría desvincula sus productos, sube sus subcategorías un nivel y la quita de las rutas de impresión, los descuentos y las colecciones."
                                }
                            },
                            "additionalProperties": false
                        }
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatch"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "catalog:write"
                        ]
                    }
                ],
                "responses": {
                    "204": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "consent_required",
                    "idempotency_key_in_use",
                    "in_use_conflict",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            }
        },
        "/categories/by-external-id/{external_id}": {
            "get": {
                "operationId": "categories.get_by_external_id",
                "summary": "Obtener una categoría del catálogo por su ID externo",
                "tags": [
                    "Categories"
                ],
                "parameters": [
                    {
                        "name": "external_id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "ID externo: el ID del registro en tu sistema."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "catalog:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Category"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            },
            "patch": {
                "operationId": "categories.upsert",
                "summary": "Crear o cambiar una categoría del catálogo por su ID externo",
                "tags": [
                    "Categories"
                ],
                "parameters": [
                    {
                        "name": "external_id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "ID externo: el ID del registro en tu sistema."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatchUpsert"
                    },
                    {
                        "$ref": "#/components/parameters/IfNoneMatch"
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/UpsertCategoryRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "catalog:write"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Category"
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Creado",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            },
                            "Location": {
                                "$ref": "#/components/headers/Location"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Category"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "external_id_archived",
                    "idempotency_key_in_use",
                    "plan_limit_reached",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            }
        },
        "/consignment-settlements": {
            "get": {
                "operationId": "consignment_settlements.list",
                "summary": "Liquidaciones de consignación: mercadería en consignación vendida, dada de baja a cargo de la tienda y reajustada en un período",
                "tags": [
                    "ConsignmentSettlements"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Tamaño de página: hasta 250 registros; 50 por defecto."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Cursor opaco: next_cursor de la página anterior, o sync_cursor de la última página guardado por la sincronización anterior. El listado va en orden de confirmación, así que el cursor de sincronización devuelve luego solo lo que cambió después de él."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Solo los registros cambiados después de este momento, ISO 8601 con zona horaria. Un filtro de la primera sincronización; después se sigue con el cursor."
                    },
                    {
                        "name": "supplier_id",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        },
                        "description": "Solo documentos de este proveedor."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "procurement:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/ConsignmentSettlement"
                                            },
                                            "description": "Registros de la página."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID del registro borrado."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Cuándo se borró el registro."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Registros borrados de la base desde el cursor, como marcas de eliminación: solo con include_deleted=true en la continuación por el cursor de sincronización."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Cursor de la página siguiente; null en la última."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true si hay una página siguiente."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "En la última página — el cursor desde el que continuar más tarde: con él llega solo lo que cambió después de esta página. null en las demás."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            }
        },
        "/consignment-settlements/{consignment_settlement}": {
            "get": {
                "operationId": "consignment_settlements.get",
                "summary": "Liquidación de consignación",
                "tags": [
                    "ConsignmentSettlements"
                ],
                "parameters": [
                    {
                        "name": "consignment_settlement",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID de la liquidación de consignación."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "procurement:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ConsignmentSettlement"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            }
        },
        "/customer-account-entries": {
            "get": {
                "operationId": "customer_account_entries.list",
                "summary": "Movimientos de las cuentas corrientes de clientes: venta a cuenta, cobro, devolución, baja por incobrable, compensación, retención y anulación",
                "tags": [
                    "CustomerAccountEntries"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Tamaño de página: hasta 250 registros; 50 por defecto."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Cursor opaco: next_cursor de la página anterior, o sync_cursor de la última página guardado por la sincronización anterior. El listado va en orden de confirmación, así que el cursor de sincronización devuelve luego solo lo que cambió después de él."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Solo los registros cambiados después de este momento, ISO 8601 con zona horaria. Un filtro de la primera sincronización; después se sigue con el cursor."
                    },
                    {
                        "name": "customer_account_id",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        },
                        "description": "Solo los movimientos de esta cuenta corriente."
                    },
                    {
                        "name": "payment_id",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        },
                        "description": "Solo los movimientos de este pago."
                    },
                    {
                        "name": "order_id",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        },
                        "description": "Solo los registros de este pedido."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "finance:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/CustomerAccountEntry"
                                            },
                                            "description": "Registros de la página."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID del registro borrado."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Cuándo se borró el registro."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Registros borrados de la base desde el cursor, como marcas de eliminación: solo con include_deleted=true en la continuación por el cursor de sincronización."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Cursor de la página siguiente; null en la última."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true si hay una página siguiente."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "En la última página — el cursor desde el que continuar más tarde: con él llega solo lo que cambió después de esta página. null en las demás."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            }
        },
        "/customer-account-entries/{customer_account_entry}": {
            "get": {
                "operationId": "customer_account_entries.get",
                "summary": "Movimiento de la cuenta corriente de un cliente",
                "tags": [
                    "CustomerAccountEntries"
                ],
                "parameters": [
                    {
                        "name": "customer_account_entry",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID del movimiento de la cuenta corriente."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "finance:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/CustomerAccountEntry"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            }
        },
        "/customer-accounts": {
            "get": {
                "operationId": "customer_accounts.list",
                "summary": "Cuentas corrientes de clientes: saldo, límite de crédito y plazo de pago",
                "tags": [
                    "CustomerAccounts"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Tamaño de página: hasta 250 registros; 50 por defecto."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Cursor opaco: next_cursor de la página anterior, o sync_cursor de la última página guardado por la sincronización anterior. El listado va en orden de confirmación, así que el cursor de sincronización devuelve luego solo lo que cambió después de él."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Solo los registros cambiados después de este momento, ISO 8601 con zona horaria. Un filtro de la primera sincronización; después se sigue con el cursor."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "finance:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/CustomerAccount"
                                            },
                                            "description": "Registros de la página."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID del registro borrado."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Cuándo se borró el registro."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Registros borrados de la base desde el cursor, como marcas de eliminación: solo con include_deleted=true en la continuación por el cursor de sincronización."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Cursor de la página siguiente; null en la última."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true si hay una página siguiente."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "En la última página — el cursor desde el que continuar más tarde: con él llega solo lo que cambió después de esta página. null en las demás."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            }
        },
        "/customer-accounts/{customer_account}": {
            "get": {
                "operationId": "customer_accounts.get",
                "summary": "Cuenta corriente de un cliente",
                "tags": [
                    "CustomerAccounts"
                ],
                "parameters": [
                    {
                        "name": "customer_account",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID de la cuenta corriente del cliente."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "finance:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/CustomerAccount"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            }
        },
        "/customer-accounts/{customer_account}/statement": {
            "get": {
                "operationId": "customer_accounts.get_statement",
                "summary": "Resumen de la cuenta corriente de un cliente en un período: saldo inicial y final, movimientos con saldo acumulado y deudas abiertas con vencimiento",
                "tags": [
                    "CustomerAccounts"
                ],
                "parameters": [
                    {
                        "name": "customer_account",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID de la cuenta corriente del cliente."
                    },
                    {
                        "name": "from",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date"
                        },
                        "description": "Primer día del período, AAAA-MM-DD en la zona horaria de la tienda; por defecto, el día de la primera operación de la cuenta."
                    },
                    {
                        "name": "to",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date"
                        },
                        "description": "Último día del período, AAAA-MM-DD en la zona horaria de la tienda; por defecto, hoy."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "finance:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/CustomerAccountStatement"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            }
        },
        "/customer-accounts/{customer_account}/payments": {
            "post": {
                "operationId": "customer_accounts.record_payment",
                "summary": "Registrar un cobro de cuenta corriente con dinero ya recibido: entrada en la cuenta corriente con certificados de retención",
                "tags": [
                    "CustomerAccounts"
                ],
                "parameters": [
                    {
                        "name": "customer_account",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID de la cuenta corriente del cliente."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/RecordCustomerAccountPaymentRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "finance:write"
                        ]
                    }
                ],
                "responses": {
                    "201": {
                        "description": "Creado",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/CustomerAccountEntry"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "idempotency_key_reused",
                    "invalid_idempotency_key"
                ]
            }
        },
        "/customers/{customer}/addresses/{address}": {
            "get": {
                "operationId": "customer_addresses.get",
                "summary": "Obtener una dirección de la libreta del cliente",
                "tags": [
                    "CustomerAddresses"
                ],
                "parameters": [
                    {
                        "name": "customer",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID del cliente."
                    },
                    {
                        "name": "address",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID de la dirección en la libreta del cliente."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "customers:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/CustomerAddress"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            },
            "patch": {
                "operationId": "customer_addresses.update",
                "summary": "Actualizar una dirección del cliente",
                "tags": [
                    "CustomerAddresses"
                ],
                "parameters": [
                    {
                        "name": "customer",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID del cliente."
                    },
                    {
                        "name": "address",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID de la dirección en la libreta del cliente."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatch"
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/UpdateCustomerAddressRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "customers:write"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/CustomerAddress"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            },
            "delete": {
                "operationId": "customer_addresses.delete",
                "summary": "Eliminar una dirección de la libreta del cliente",
                "tags": [
                    "CustomerAddresses"
                ],
                "parameters": [
                    {
                        "name": "customer",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID del cliente."
                    },
                    {
                        "name": "address",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID de la dirección en la libreta del cliente."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatch"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "customers:write"
                        ]
                    }
                ],
                "responses": {
                    "204": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "in_use_conflict",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            }
        },
        "/customers/{customer}/addresses": {
            "post": {
                "operationId": "customer_addresses.create",
                "summary": "Agregar una dirección a la libreta del cliente",
                "tags": [
                    "CustomerAddresses"
                ],
                "parameters": [
                    {
                        "name": "customer",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID del cliente."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/CreateCustomerAddressRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "customers:write"
                        ]
                    }
                ],
                "responses": {
                    "201": {
                        "description": "Creado",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            },
                            "Location": {
                                "$ref": "#/components/headers/Location"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/CustomerAddress"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "address_book_full",
                    "idempotency_key_in_use",
                    "idempotency_key_reused",
                    "invalid_idempotency_key"
                ]
            }
        },
        "/customers/{customer}/fiscal-profile": {
            "get": {
                "operationId": "customer_fiscal_profiles.get",
                "summary": "Obtener los datos fiscales de un cliente",
                "tags": [
                    "CustomerFiscalProfiles"
                ],
                "parameters": [
                    {
                        "name": "customer",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID del cliente."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "customers:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/CustomerFiscalProfile"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            },
            "put": {
                "operationId": "customer_fiscal_profiles.replace",
                "summary": "Reemplazar los datos fiscales de un cliente; null lo vuelve consumidor sin datos fiscales",
                "tags": [
                    "CustomerFiscalProfiles"
                ],
                "parameters": [
                    {
                        "name": "customer",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID del cliente."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatch"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/ReplaceCustomerFiscalProfileRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "customers:write"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/CustomerFiscalProfile"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            }
        },
        "/customer-groups": {
            "get": {
                "operationId": "customer_groups.list",
                "summary": "Listar los grupos de clientes de la tienda: nombre, descripción y si están activos",
                "tags": [
                    "CustomerGroups"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Tamaño de página: hasta 250 registros; 50 por defecto."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Cursor opaco: next_cursor de la página anterior, o sync_cursor de la última página guardado por la sincronización anterior. El listado va en orden de confirmación, así que el cursor de sincronización devuelve luego solo lo que cambió después de él."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Solo los registros cambiados después de este momento, ISO 8601 con zona horaria. Un filtro de la primera sincronización; después se sigue con el cursor."
                    },
                    {
                        "name": "include_deleted",
                        "in": "query",
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "true — devolver también los registros eliminados: los archivados con deleted_at y los borrados de la base como marcas de eliminación {id, deleted_at} en la continuación por el cursor de sincronización. Activalo para sincronizar."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "customers:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/CustomerGroup"
                                            },
                                            "description": "Registros de la página."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID del registro borrado."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Cuándo se borró el registro."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Registros borrados de la base desde el cursor, como marcas de eliminación: solo con include_deleted=true en la continuación por el cursor de sincronización."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Cursor de la página siguiente; null en la última."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true si hay una página siguiente."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "En la última página — el cursor desde el que continuar más tarde: con él llega solo lo que cambió después de esta página. null en las demás."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            },
            "post": {
                "operationId": "customer_groups.create",
                "summary": "Crear un grupo de clientes",
                "tags": [
                    "CustomerGroups"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/CreateCustomerGroupRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "customers:write"
                        ]
                    }
                ],
                "responses": {
                    "201": {
                        "description": "Creado",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            },
                            "Location": {
                                "$ref": "#/components/headers/Location"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/CustomerGroup"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "record_limit_reached",
                    "idempotency_key_reused",
                    "invalid_idempotency_key"
                ]
            }
        },
        "/customer-groups/{customer_group}": {
            "get": {
                "operationId": "customer_groups.get",
                "summary": "Obtener un grupo de clientes",
                "tags": [
                    "CustomerGroups"
                ],
                "parameters": [
                    {
                        "name": "customer_group",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID del grupo de clientes."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "customers:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/CustomerGroup"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            },
            "patch": {
                "operationId": "customer_groups.update",
                "summary": "Cambiar el nombre, la descripción o la actividad de un grupo",
                "tags": [
                    "CustomerGroups"
                ],
                "parameters": [
                    {
                        "name": "customer_group",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID del grupo de clientes."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatch"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "customers:write"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/CustomerGroup"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            },
            "delete": {
                "operationId": "customer_groups.delete",
                "summary": "Eliminar un grupo: sus membresías se van con él, y las reglas de descuento y los envíos dejan de apuntarle",
                "tags": [
                    "CustomerGroups"
                ],
                "parameters": [
                    {
                        "name": "customer_group",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID del grupo de clientes."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatch"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "customers:write"
                        ]
                    }
                ],
                "responses": {
                    "204": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "in_use_conflict",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            }
        },
        "/customer-groups/{customer_group}/members": {
            "post": {
                "operationId": "customer_groups.add_members",
                "summary": "Agregar clientes a un grupo",
                "tags": [
                    "CustomerGroups"
                ],
                "parameters": [
                    {
                        "name": "customer_group",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID del grupo de clientes."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/ChangeCustomerGroupMembersRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "customers:write"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/CustomerGroup"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "idempotency_key_reused",
                    "invalid_idempotency_key"
                ]
            }
        },
        "/customer-groups/{customer_group}/members/remove": {
            "post": {
                "operationId": "customer_groups.remove_members",
                "summary": "Quitar clientes de un grupo",
                "tags": [
                    "CustomerGroups"
                ],
                "parameters": [
                    {
                        "name": "customer_group",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID del grupo de clientes."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/ChangeCustomerGroupMembersRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "customers:write"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/CustomerGroup"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "idempotency_key_reused",
                    "invalid_idempotency_key"
                ]
            }
        },
        "/customers": {
            "get": {
                "operationId": "customers.list",
                "summary": "Listar los clientes cambiados desde un momento dado: contactos, consentimiento de marketing, direcciones y grupos; búsqueda por teléfono, email y grupo",
                "tags": [
                    "Customers"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Tamaño de página: hasta 250 registros; 50 por defecto."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Cursor opaco: next_cursor de la página anterior, o sync_cursor de la última página guardado por la sincronización anterior. El listado va en orden de confirmación, así que el cursor de sincronización devuelve luego solo lo que cambió después de él."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Solo los registros cambiados después de este momento, ISO 8601 con zona horaria. Un filtro de la primera sincronización; después se sigue con el cursor."
                    },
                    {
                        "name": "include_deleted",
                        "in": "query",
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "true — devolver también los registros eliminados: los archivados con deleted_at y los borrados de la base como marcas de eliminación {id, deleted_at} en la continuación por el cursor de sincronización. Activalo para sincronizar."
                    },
                    {
                        "name": "phone",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 32
                        },
                        "description": "Solo los clientes con este teléfono, en formato E.164."
                    },
                    {
                        "name": "email",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 254
                        },
                        "description": "Solo los clientes con este email."
                    },
                    {
                        "name": "group_id",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        },
                        "description": "Solo los clientes de este grupo: sus miembros actuales."
                    },
                    {
                        "name": "wholesale_price_list_id",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        },
                        "description": "Solo los clientes con esta lista de precios mayorista asignada."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "customers:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/Customer"
                                            },
                                            "description": "Registros de la página."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID del registro borrado."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Cuándo se borró el registro."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Registros borrados de la base desde el cursor, como marcas de eliminación: solo con include_deleted=true en la continuación por el cursor de sincronización."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Cursor de la página siguiente; null en la última."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true si hay una página siguiente."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "En la última página — el cursor desde el que continuar más tarde: con él llega solo lo que cambió después de esta página. null en las demás."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            },
            "post": {
                "operationId": "customers.create",
                "summary": "Crear un cliente: un nombre y al menos un contacto",
                "tags": [
                    "Customers"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/CreateCustomerRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "customers:write"
                        ]
                    }
                ],
                "responses": {
                    "201": {
                        "description": "Creado",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            },
                            "Location": {
                                "$ref": "#/components/headers/Location"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Customer"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "customer_contact_in_use",
                    "external_id_in_use",
                    "idempotency_key_in_use",
                    "idempotency_key_reused",
                    "invalid_idempotency_key"
                ]
            }
        },
        "/customers/{customer}": {
            "get": {
                "operationId": "customers.get",
                "summary": "Obtener un cliente",
                "tags": [
                    "Customers"
                ],
                "parameters": [
                    {
                        "name": "customer",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID del cliente."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "customers:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Customer"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            },
            "patch": {
                "operationId": "customers.update",
                "summary": "Actualizar el nombre, el idioma y el ID externo de un cliente",
                "tags": [
                    "Customers"
                ],
                "parameters": [
                    {
                        "name": "customer",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID del cliente."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatch"
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/UpdateCustomerRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "customers:write"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Customer"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "customer_contact_in_use",
                    "external_id_in_use",
                    "idempotency_key_in_use",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            }
        },
        "/customers/by-external-id/{external_id}": {
            "get": {
                "operationId": "customers.get_by_external_id",
                "summary": "Obtener un cliente por su ID externo",
                "tags": [
                    "Customers"
                ],
                "parameters": [
                    {
                        "name": "external_id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "ID externo: el ID del registro en tu sistema."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "customers:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Customer"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            },
            "patch": {
                "operationId": "customers.upsert",
                "summary": "Crear o actualizar un cliente por su ID externo",
                "tags": [
                    "Customers"
                ],
                "parameters": [
                    {
                        "name": "external_id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "ID externo: el ID del registro en tu sistema."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatchUpsert"
                    },
                    {
                        "$ref": "#/components/parameters/IfNoneMatch"
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/UpsertCustomerRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "customers:write"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Customer"
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Creado",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            },
                            "Location": {
                                "$ref": "#/components/headers/Location"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Customer"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "customer_contact_in_use",
                    "idempotency_key_in_use",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            }
        },
        "/customers/{customer}/wholesale-price-list": {
            "post": {
                "operationId": "customers.set_wholesale_price_list",
                "summary": "Asignar a un cliente una lista de precios mayorista o quitársela",
                "tags": [
                    "Customers"
                ],
                "parameters": [
                    {
                        "name": "customer",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID del cliente."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatch"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/SetCustomerWholesalePriceListRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "customers:write",
                            "orders:wholesale"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Customer"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            }
        },
        "/delivery-methods": {
            "get": {
                "operationId": "delivery_methods.list",
                "summary": "Listar los métodos de entrega de la tienda",
                "tags": [
                    "DeliveryMethods"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Tamaño de página: hasta 250 registros; 50 por defecto."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Cursor opaco: next_cursor de la página anterior, o sync_cursor de la última página guardado por la sincronización anterior. El listado va en orden de confirmación, así que el cursor de sincronización devuelve luego solo lo que cambió después de él."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Solo los registros cambiados después de este momento, ISO 8601 con zona horaria. Un filtro de la primera sincronización; después se sigue con el cursor."
                    },
                    {
                        "name": "include_deleted",
                        "in": "query",
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "true — devolver también los registros eliminados: los archivados con deleted_at y los borrados de la base como marcas de eliminación {id, deleted_at} en la continuación por el cursor de sincronización. Activalo para sincronizar."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "orders:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/DeliveryMethod"
                                            },
                                            "description": "Registros de la página."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID del registro borrado."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Cuándo se borró el registro."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Registros borrados de la base desde el cursor, como marcas de eliminación: solo con include_deleted=true en la continuación por el cursor de sincronización."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Cursor de la página siguiente; null en la última."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true si hay una página siguiente."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "En la última página — el cursor desde el que continuar más tarde: con él llega solo lo que cambió después de esta página. null en las demás."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            }
        },
        "/draft-orders/{draft}": {
            "get": {
                "operationId": "draft_orders.get",
                "summary": "Obtener un borrador de pedido: ítems, totales y lo que impide confirmarlo",
                "tags": [
                    "DraftOrders"
                ],
                "parameters": [
                    {
                        "name": "draft",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID del borrador de pedido."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "orders:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/DraftOrder"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            },
            "patch": {
                "operationId": "draft_orders.update",
                "summary": "Cambiar un borrador de pedido: cliente, entrega, medio de pago e ítems",
                "tags": [
                    "DraftOrders"
                ],
                "parameters": [
                    {
                        "name": "draft",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID del borrador de pedido."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatch"
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/UpdateDraftOrderRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "orders:write"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/DraftOrder"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "draft_order_closed",
                    "idempotency_key_in_use",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            },
            "delete": {
                "operationId": "draft_orders.delete",
                "summary": "Eliminar un borrador de pedido",
                "tags": [
                    "DraftOrders"
                ],
                "parameters": [
                    {
                        "name": "draft",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID del borrador de pedido."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatch"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "orders:write"
                        ]
                    }
                ],
                "responses": {
                    "204": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "in_use_conflict",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            }
        },
        "/draft-orders": {
            "post": {
                "operationId": "draft_orders.create",
                "summary": "Crear un borrador de pedido para un cliente",
                "tags": [
                    "DraftOrders"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/CreateDraftOrderRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "orders:write"
                        ]
                    }
                ],
                "responses": {
                    "201": {
                        "description": "Creado",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            },
                            "Location": {
                                "$ref": "#/components/headers/Location"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/DraftOrder"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "idempotency_key_reused",
                    "invalid_idempotency_key"
                ]
            }
        },
        "/draft-orders/{draft}/complete": {
            "post": {
                "operationId": "draft_orders.complete",
                "summary": "Confirmar el pedido desde un borrador: cobrarle al cliente o registrar el pago como recibido",
                "tags": [
                    "DraftOrders"
                ],
                "parameters": [
                    {
                        "name": "draft",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID del borrador de pedido."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatch"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/CompleteDraftOrderRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "orders:write"
                        ]
                    }
                ],
                "responses": {
                    "201": {
                        "description": "Creado",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Order"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "draft_order_closed",
                    "idempotency_key_in_use",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            }
        },
        "/events": {
            "get": {
                "operationId": "events.list",
                "summary": "Listar los eventos de la tienda de los últimos 30 días: qué cambió en pedidos, pagos, devoluciones, comprobantes fiscales, períodos fiscales, productos, stock y clientes, con el registro tal como está ahora",
                "tags": [
                    "Events"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Tamaño de página: hasta 250 registros; 50 por defecto."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Cursor opaco: next_cursor de la página anterior, o sync_cursor de la última página guardado por la sincronización anterior. El listado va en orden de confirmación, así que el cursor de sincronización devuelve luego solo lo que cambió después de él."
                    },
                    {
                        "name": "type",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "enum": [
                                "order.created",
                                "order.updated",
                                "order.status_changed",
                                "order.paid",
                                "order.cancelled",
                                "payment.created",
                                "payment.succeeded",
                                "payment.status_changed",
                                "payment.updated",
                                "refund.created",
                                "refund.completed",
                                "refund.status_changed",
                                "refund.updated",
                                "fiscal_document.created",
                                "fiscal_document.updated",
                                "fiscal_document.issued",
                                "fiscal_document.failed",
                                "fiscal_document.annulled",
                                "tax_period.status_changed",
                                "money_transaction.created",
                                "money_transaction.updated",
                                "money_transaction.deleted",
                                "pos_shift.opened",
                                "pos_shift.closed",
                                "pos_shift.updated",
                                "pos_cash_movement.created",
                                "gift_card.created",
                                "gift_card.updated",
                                "gift_card_transaction.created",
                                "customer_account.created",
                                "customer_account.updated",
                                "customer_account_entry.created",
                                "customer_account_entry.updated",
                                "supplier.created",
                                "supplier.updated",
                                "supplier.deleted",
                                "supplier_bill.created",
                                "supplier_bill.updated",
                                "supplier_bill.posted",
                                "supplier_bill.voided",
                                "supplier_bill.deleted",
                                "supplier_bill_payment.created",
                                "supplier_bill_payment.updated",
                                "supplier_bill_payment.deleted",
                                "settlement_agreement.created",
                                "settlement_agreement.updated",
                                "settlement_agreement.deleted",
                                "settlement_offset.created",
                                "settlement_offset.updated",
                                "settlement_offset.voided",
                                "purchase_order.created",
                                "purchase_order.updated",
                                "purchase_order.status_changed",
                                "purchase_order.deleted",
                                "goods_receipt.created",
                                "goods_receipt.updated",
                                "goods_receipt.voided",
                                "supplier_return.created",
                                "supplier_return.updated",
                                "supplier_return.status_changed",
                                "supplier_return.deleted",
                                "consignment_settlement.created",
                                "consignment_settlement.updated",
                                "consignment_settlement.posted",
                                "consignment_settlement.voided",
                                "tax_withholding.created",
                                "tax_withholding.updated",
                                "tax_withholding.annulled",
                                "tax_withholding.deleted",
                                "product.created",
                                "product.updated",
                                "product.deleted",
                                "inventory_level.updated",
                                "stock_movement.created",
                                "stock_movement.updated",
                                "lot.created",
                                "lot.updated",
                                "lot.deleted",
                                "location_transfer.created",
                                "location_transfer.updated",
                                "stocktake.created",
                                "stocktake.status_changed",
                                "stocktake.updated",
                                "customer.created",
                                "customer.updated",
                                "customer.deleted",
                                "customer_group.created",
                                "customer_group.updated",
                                "customer_group.deleted",
                                "price_list.created",
                                "price_list.updated",
                                "price_list.deleted",
                                "bulk_operation.finished"
                            ]
                        },
                        "description": "Solo los eventos de este tipo, como order.paid."
                    },
                    {
                        "name": "created_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Solo los eventos creados después de este momento."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "webhooks:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/Event"
                                            },
                                            "description": "Registros de la página."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID del registro borrado."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Cuándo se borró el registro."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Registros borrados de la base desde el cursor, como marcas de eliminación: solo con include_deleted=true en la continuación por el cursor de sincronización."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Cursor de la página siguiente; null en la última."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true si hay una página siguiente."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "En la última página — el cursor desde el que continuar más tarde: con él llega solo lo que cambió después de esta página. null en las demás."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            }
        },
        "/exchange-rates/{currency}": {
            "get": {
                "operationId": "exchange_rates.get",
                "summary": "Obtener la cotización contable del día de una moneda en una fecha: con ella el libro de dinero convierte los movimientos de las cuentas en moneda extranjera",
                "tags": [
                    "ExchangeRates"
                ],
                "parameters": [
                    {
                        "name": "currency",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Código de moneda ISO 4217 o de activo (USDT, USDC) del conjunto de monedas de las cuentas de dinero."
                    },
                    {
                        "name": "date",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date"
                        },
                        "description": "Fecha contable AAAA-MM-DD en la zona horaria de la tienda; por defecto, hoy."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "finance:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ExchangeRate"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            }
        },
        "/fiscal-documents": {
            "get": {
                "operationId": "fiscal_documents.list",
                "summary": "Listar los comprobantes fiscales cambiados desde un momento: facturas, notas de crédito y de débito en todos los estados",
                "tags": [
                    "FiscalDocuments"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Tamaño de página: hasta 250 registros; 50 por defecto."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Cursor opaco: next_cursor de la página anterior, o sync_cursor de la última página guardado por la sincronización anterior. El listado va en orden de confirmación, así que el cursor de sincronización devuelve luego solo lo que cambió después de él."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Solo los registros cambiados después de este momento, ISO 8601 con zona horaria. Un filtro de la primera sincronización; después se sigue con el cursor."
                    },
                    {
                        "name": "include_deleted",
                        "in": "query",
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "true — devolver también los registros eliminados: los archivados con deleted_at y los borrados de la base como marcas de eliminación {id, deleted_at} en la continuación por el cursor de sincronización. Activalo para sincronizar."
                    },
                    {
                        "name": "order_id",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        },
                        "description": "Solo los registros de este pedido."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "fiscal:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/FiscalDocument"
                                            },
                                            "description": "Registros de la página."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID del registro borrado."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Cuándo se borró el registro."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Registros borrados de la base desde el cursor, como marcas de eliminación: solo con include_deleted=true en la continuación por el cursor de sincronización."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Cursor de la página siguiente; null en la última."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true si hay una página siguiente."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "En la última página — el cursor desde el que continuar más tarde: con él llega solo lo que cambió después de esta página. null en las demás."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            }
        },
        "/fiscal-documents/{document}": {
            "get": {
                "operationId": "fiscal_documents.get",
                "summary": "Obtener un comprobante fiscal",
                "tags": [
                    "FiscalDocuments"
                ],
                "parameters": [
                    {
                        "name": "document",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID del comprobante fiscal."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "fiscal:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/FiscalDocument"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            }
        },
        "/fiscal-documents/{document}/pdf": {
            "get": {
                "operationId": "fiscal_documents.get_pdf",
                "summary": "Descargar el PDF de un comprobante fiscal, el mismo archivo que recibe el cliente",
                "tags": [
                    "FiscalDocuments"
                ],
                "parameters": [
                    {
                        "name": "document",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID del comprobante fiscal."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "fiscal:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/pdf": {
                                "schema": {
                                    "type": "string",
                                    "format": "binary"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "fiscal_document_pdf_unavailable"
                ]
            }
        },
        "/orders/{order}/invoice": {
            "post": {
                "operationId": "fiscal_documents.issue_invoice",
                "summary": "Emitir la factura de una venta cerrada: la emisión corre en segundo plano y el resultado llega como evento",
                "tags": [
                    "FiscalDocuments"
                ],
                "parameters": [
                    {
                        "name": "order",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID del pedido."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKeyRequired"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "fiscal:write"
                        ]
                    }
                ],
                "responses": {
                    "202": {
                        "description": "Aceptado: el resultado está en la dirección de Location",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "Location": {
                                "$ref": "#/components/headers/Location"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/FiscalDocument"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "invoice_issue_refused",
                    "idempotency_key_required",
                    "idempotency_key_reused",
                    "invalid_idempotency_key"
                ]
            }
        },
        "/fiscal-documents/{document}/reissue": {
            "post": {
                "operationId": "fiscal_documents.reissue",
                "summary": "Reemitir un comprobante tras una falla o un rechazo del fisco",
                "tags": [
                    "FiscalDocuments"
                ],
                "parameters": [
                    {
                        "name": "document",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "ID del comprobante fiscal."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKeyRequired"
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/ReissueFiscalDocumentRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "fiscal:write"
                        ]
                    }
                ],
                "responses": {
                    "202": {
                        "description": "Aceptado: el resultado está en la dirección de Location",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "Location": {
                                "$ref": "#/components/headers/Location"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/FiscalDocument"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "fiscal_document_reissue_refused",
                    "idempotency_key_in_use",
                    "idempotency_key_required",
                    "idempotency_key_reused",
                    "invalid_idempotency_key"
                ]
            }
        },
        "/fiscal-documents/{document}/dismiss": {
            "post": {
                "operationId": "fiscal_documents.dismiss",
                "summary": "Sacar de control un comprobante rechazado: no se va a emitir",
                "tags": [
                    "FiscalDocuments"
                ],
                "parameters": [
                    {
                        "name": "document",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "ID del comprobante fiscal."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/DismissFiscalDocumentRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "fiscal:write"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/FiscalDocument"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "fiscal_document_dismiss_refused",
                    "idempotency_key_in_use",
                    "idempotency_key_reused",
                    "invalid_idempotency_key"
                ]
            }
        },
        "/fiscal-documents/{document}/annul": {
            "post": {
                "operationId": "fiscal_documents.annul",
                "summary": "Anular una factura emitida con una nota de crédito",
                "tags": [
                    "FiscalDocuments"
                ],
                "parameters": [
                    {
                        "name": "document",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "ID del comprobante fiscal."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKeyRequired"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/AnnulFiscalDocumentRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "fiscal:annul"
                        ]
                    }
                ],
                "responses": {
                    "202": {
                        "description": "Aceptado: el resultado está en la dirección de Location",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "Location": {
                                "$ref": "#/components/headers/Location"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/FiscalDocument"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "fiscal_document_annul_refused",
                    "idempotency_key_in_use",
                    "idempotency_key_required",
                    "idempotency_key_reused",
                    "invalid_idempotency_key"
                ]
            }
        },
        "/gift-card-transactions": {
            "get": {
                "operationId": "gift_card_transactions.list",
                "summary": "Movimientos de tarjetas de regalo: emisión, canje, devolución a la tarjeta, ajuste, anulación, bloqueo y traspaso de saldo",
                "tags": [
                    "GiftCardTransactions"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Tamaño de página: hasta 250 registros; 50 por defecto."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Cursor opaco: next_cursor de la página anterior, o sync_cursor de la última página guardado por la sincronización anterior. El listado va en orden de confirmación, así que el cursor de sincronización devuelve luego solo lo que cambió después de él."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Solo los registros cambiados después de este momento, ISO 8601 con zona horaria. Un filtro de la primera sincronización; después se sigue con el cursor."
                    },
                    {
                        "name": "gift_card_id",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        },
                        "description": "Solo los movimientos de esta tarjeta de regalo."
                    },
                    {
                        "name": "payment_id",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        },
                        "description": "Solo los movimientos de este pago."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "finance:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/GiftCardTransaction"
                                            },
                                            "description": "Registros de la página."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID del registro borrado."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Cuándo se borró el registro."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Registros borrados de la base desde el cursor, como marcas de eliminación: solo con include_deleted=true en la continuación por el cursor de sincronización."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Cursor de la página siguiente; null en la última."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true si hay una página siguiente."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "En la última página — el cursor desde el que continuar más tarde: con él llega solo lo que cambió después de esta página. null en las demás."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            }
        },
        "/gift-card-transactions/{entry}": {
            "get": {
                "operationId": "gift_card_transactions.get",
                "summary": "Movimiento de la tarjeta de regalo",
                "tags": [
                    "GiftCardTransactions"
                ],
                "parameters": [
                    {
                        "name": "entry",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID del movimiento de la tarjeta de regalo."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "finance:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/GiftCardTransaction"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            }
        },
        "/gift-cards": {
            "get": {
                "operationId": "gift_cards.list",
                "summary": "Tarjetas de regalo: valor nominal, saldo y deuda de la tienda por cada tarjeta",
                "tags": [
                    "GiftCards"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Tamaño de página: hasta 250 registros; 50 por defecto."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Cursor opaco: next_cursor de la página anterior, o sync_cursor de la última página guardado por la sincronización anterior. El listado va en orden de confirmación, así que el cursor de sincronización devuelve luego solo lo que cambió después de él."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Solo los registros cambiados después de este momento, ISO 8601 con zona horaria. Un filtro de la primera sincronización; después se sigue con el cursor."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "finance:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/GiftCard"
                                            },
                                            "description": "Registros de la página."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID del registro borrado."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Cuándo se borró el registro."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Registros borrados de la base desde el cursor, como marcas de eliminación: solo con include_deleted=true en la continuación por el cursor de sincronización."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Cursor de la página siguiente; null en la última."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true si hay una página siguiente."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "En la última página — el cursor desde el que continuar más tarde: con él llega solo lo que cambió después de esta página. null en las demás."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            }
        },
        "/gift-cards/{card}": {
            "get": {
                "operationId": "gift_cards.get",
                "summary": "Tarjeta de regalo",
                "tags": [
                    "GiftCards"
                ],
                "parameters": [
                    {
                        "name": "card",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID de la tarjeta de regalo."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "finance:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/GiftCard"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            }
        },
        "/goods-receipts": {
            "get": {
                "operationId": "goods_receipts.list",
                "summary": "Recepciones: ingresos de mercadería del proveedor con líneas, precios del remito y correcciones",
                "tags": [
                    "GoodsReceipts"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Tamaño de página: hasta 250 registros; 50 por defecto."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Cursor opaco: next_cursor de la página anterior, o sync_cursor de la última página guardado por la sincronización anterior. El listado va en orden de confirmación, así que el cursor de sincronización devuelve luego solo lo que cambió después de él."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Solo los registros cambiados después de este momento, ISO 8601 con zona horaria. Un filtro de la primera sincronización; después se sigue con el cursor."
                    },
                    {
                        "name": "supplier_id",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        },
                        "description": "Solo documentos de este proveedor."
                    },
                    {
                        "name": "purchase_order_id",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        },
                        "description": "Solo recepciones de esta orden de compra."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "procurement:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/GoodsReceipt"
                                            },
                                            "description": "Registros de la página."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID del registro borrado."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Cuándo se borró el registro."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Registros borrados de la base desde el cursor, como marcas de eliminación: solo con include_deleted=true en la continuación por el cursor de sincronización."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Cursor de la página siguiente; null en la última."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true si hay una página siguiente."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "En la última página — el cursor desde el que continuar más tarde: con él llega solo lo que cambió después de esta página. null en las demás."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            }
        },
        "/goods-receipts/{goods_receipt}": {
            "get": {
                "operationId": "goods_receipts.get",
                "summary": "Recepción",
                "tags": [
                    "GoodsReceipts"
                ],
                "parameters": [
                    {
                        "name": "goods_receipt",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID de la recepción."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "procurement:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/GoodsReceipt"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            }
        },
        "/inventory-levels": {
            "get": {
                "operationId": "inventory_levels.list",
                "summary": "Listar el stock por local cambiado desde un momento dado",
                "tags": [
                    "InventoryLevels"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Tamaño de página: hasta 250 registros; 50 por defecto."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Cursor opaco: next_cursor de la página anterior, o sync_cursor de la última página guardado por la sincronización anterior. El listado va en orden de confirmación, así que el cursor de sincronización devuelve luego solo lo que cambió después de él."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Solo los registros cambiados después de este momento, ISO 8601 con zona horaria. Un filtro de la primera sincronización; después se sigue con el cursor."
                    },
                    {
                        "name": "include_deleted",
                        "in": "query",
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "true — devolver también los registros eliminados: los archivados con deleted_at y los borrados de la base como marcas de eliminación {id, deleted_at} en la continuación por el cursor de sincronización. Activalo para sincronizar."
                    },
                    {
                        "name": "variant_id",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        },
                        "description": "Solo el stock de esta variante."
                    },
                    {
                        "name": "location_id",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        },
                        "description": "Solo el stock de este local."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "inventory:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/InventoryLevel"
                                            },
                                            "description": "Registros de la página."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID del registro borrado."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Cuándo se borró el registro."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Registros borrados de la base desde el cursor, como marcas de eliminación: solo con include_deleted=true en la continuación por el cursor de sincronización."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Cursor de la página siguiente; null en la última."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true si hay una página siguiente."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "En la última página — el cursor desde el que continuar más tarde: con él llega solo lo que cambió después de esta página. null en las demás."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            }
        },
        "/inventory-levels/set": {
            "post": {
                "operationId": "inventory_levels.set",
                "summary": "Fijar el stock físico de una variante en un local",
                "tags": [
                    "InventoryLevels"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/SetInventoryLevelRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "inventory:write"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/InventoryChange"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "stock_held_by_write_offs",
                    "stock_on_hand_changed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key"
                ]
            }
        },
        "/inventory-levels/adjust": {
            "post": {
                "operationId": "inventory_levels.adjust",
                "summary": "Ingresar stock o darlo de baja en un local",
                "tags": [
                    "InventoryLevels"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/AdjustInventoryLevelRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "inventory:write"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/InventoryChange"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "idempotency_key_reused",
                    "invalid_idempotency_key"
                ]
            }
        },
        "/legal-entities": {
            "get": {
                "operationId": "legal_entities.list",
                "summary": "Listar las razones sociales de la tienda: emisoras de comprobantes fiscales y titulares de los períodos fiscales",
                "tags": [
                    "LegalEntities"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Tamaño de página: hasta 250 registros; 50 por defecto."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Cursor opaco: next_cursor de la página anterior, o sync_cursor de la última página guardado por la sincronización anterior. El listado va en orden de confirmación, así que el cursor de sincronización devuelve luego solo lo que cambió después de él."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Solo los registros cambiados después de este momento, ISO 8601 con zona horaria. Un filtro de la primera sincronización; después se sigue con el cursor."
                    },
                    {
                        "name": "include_deleted",
                        "in": "query",
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "true — devolver también los registros eliminados: los archivados con deleted_at y los borrados de la base como marcas de eliminación {id, deleted_at} en la continuación por el cursor de sincronización. Activalo para sincronizar."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "fiscal:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/LegalEntity"
                                            },
                                            "description": "Registros de la página."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID del registro borrado."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Cuándo se borró el registro."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Registros borrados de la base desde el cursor, como marcas de eliminación: solo con include_deleted=true en la continuación por el cursor de sincronización."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Cursor de la página siguiente; null en la última."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true si hay una página siguiente."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "En la última página — el cursor desde el que continuar más tarde: con él llega solo lo que cambió después de esta página. null en las demás."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            }
        },
        "/location-transfers": {
            "get": {
                "operationId": "location_transfers.list",
                "summary": "Traslados de mercadería entre locales con sus líneas, modificados desde un momento dado",
                "tags": [
                    "LocationTransfers"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Tamaño de página: hasta 250 registros; 50 por defecto."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Cursor opaco: next_cursor de la página anterior, o sync_cursor de la última página guardado por la sincronización anterior. El listado va en orden de confirmación, así que el cursor de sincronización devuelve luego solo lo que cambió después de él."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Solo los registros cambiados después de este momento, ISO 8601 con zona horaria. Un filtro de la primera sincronización; después se sigue con el cursor."
                    },
                    {
                        "name": "source_location_id",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        },
                        "description": "Solo traslados que sacaron mercadería de este local."
                    },
                    {
                        "name": "destination_location_id",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        },
                        "description": "Solo traslados que trajeron mercadería a este local."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "inventory:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/LocationTransfer"
                                            },
                                            "description": "Registros de la página."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID del registro borrado."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Cuándo se borró el registro."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Registros borrados de la base desde el cursor, como marcas de eliminación: solo con include_deleted=true en la continuación por el cursor de sincronización."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Cursor de la página siguiente; null en la última."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true si hay una página siguiente."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "En la última página — el cursor desde el que continuar más tarde: con él llega solo lo que cambió después de esta página. null en las demás."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            }
        },
        "/location-transfers/{location_transfer}": {
            "get": {
                "operationId": "location_transfers.get",
                "summary": "Traslado entre locales",
                "tags": [
                    "LocationTransfers"
                ],
                "parameters": [
                    {
                        "name": "location_transfer",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID del traslado entre locales."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "inventory:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/LocationTransfer"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            }
        },
        "/locations": {
            "get": {
                "operationId": "locations.list",
                "summary": "Listar los locales de la tienda disponibles para la aplicación",
                "tags": [
                    "Locations"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Tamaño de página: hasta 250 registros; 50 por defecto."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Cursor opaco: next_cursor de la página anterior, o sync_cursor de la última página guardado por la sincronización anterior. El listado va en orden de confirmación, así que el cursor de sincronización devuelve luego solo lo que cambió después de él."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Solo los registros cambiados después de este momento, ISO 8601 con zona horaria. Un filtro de la primera sincronización; después se sigue con el cursor."
                    },
                    {
                        "name": "include_deleted",
                        "in": "query",
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "true — devolver también los registros eliminados: los archivados con deleted_at y los borrados de la base como marcas de eliminación {id, deleted_at} en la continuación por el cursor de sincronización. Activalo para sincronizar."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "locations:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/Location"
                                            },
                                            "description": "Registros de la página."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID del registro borrado."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Cuándo se borró el registro."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Registros borrados de la base desde el cursor, como marcas de eliminación: solo con include_deleted=true en la continuación por el cursor de sincronización."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Cursor de la página siguiente; null en la última."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true si hay una página siguiente."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "En la última página — el cursor desde el que continuar más tarde: con él llega solo lo que cambió después de esta página. null en las demás."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            }
        },
        "/lots": {
            "get": {
                "operationId": "lots.list",
                "summary": "Lotes de producto: número, vencimiento y estado, modificados desde un momento dado",
                "tags": [
                    "Lots"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Tamaño de página: hasta 250 registros; 50 por defecto."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Cursor opaco: next_cursor de la página anterior, o sync_cursor de la última página guardado por la sincronización anterior. El listado va en orden de confirmación, así que el cursor de sincronización devuelve luego solo lo que cambió después de él."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Solo los registros cambiados después de este momento, ISO 8601 con zona horaria. Un filtro de la primera sincronización; después se sigue con el cursor."
                    },
                    {
                        "name": "include_deleted",
                        "in": "query",
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "true — devolver también los registros eliminados: los archivados con deleted_at y los borrados de la base como marcas de eliminación {id, deleted_at} en la continuación por el cursor de sincronización. Activalo para sincronizar."
                    },
                    {
                        "name": "variant_id",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        },
                        "description": "Solo lotes de esta variante."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "inventory:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/Lot"
                                            },
                                            "description": "Registros de la página."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID del registro borrado."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Cuándo se borró el registro."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Registros borrados de la base desde el cursor, como marcas de eliminación: solo con include_deleted=true en la continuación por el cursor de sincronización."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Cursor de la página siguiente; null en la última."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true si hay una página siguiente."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "En la última página — el cursor desde el que continuar más tarde: con él llega solo lo que cambió después de esta página. null en las demás."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            }
        },
        "/lots/{lot}": {
            "get": {
                "operationId": "lots.get",
                "summary": "Lote de producto",
                "tags": [
                    "Lots"
                ],
                "parameters": [
                    {
                        "name": "lot",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID del lote."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "inventory:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Lot"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            }
        },
        "/manual-payment-methods": {
            "get": {
                "operationId": "manual_payment_methods.list",
                "summary": "Listar los medios de pago manuales de la tienda",
                "tags": [
                    "ManualPaymentMethods"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Tamaño de página: hasta 250 registros; 50 por defecto."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Cursor opaco: next_cursor de la página anterior, o sync_cursor de la última página guardado por la sincronización anterior. El listado va en orden de confirmación, así que el cursor de sincronización devuelve luego solo lo que cambió después de él."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Solo los registros cambiados después de este momento, ISO 8601 con zona horaria. Un filtro de la primera sincronización; después se sigue con el cursor."
                    },
                    {
                        "name": "include_deleted",
                        "in": "query",
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "true — devolver también los registros eliminados: los archivados con deleted_at y los borrados de la base como marcas de eliminación {id, deleted_at} en la continuación por el cursor de sincronización. Activalo para sincronizar."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "orders:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/ManualPaymentMethod"
                                            },
                                            "description": "Registros de la página."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID del registro borrado."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Cuándo se borró el registro."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Registros borrados de la base desde el cursor, como marcas de eliminación: solo con include_deleted=true en la continuación por el cursor de sincronización."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Cursor de la página siguiente; null en la última."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true si hay una página siguiente."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "En la última página — el cursor desde el que continuar más tarde: con él llega solo lo que cambió después de esta página. null en las demás."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            }
        },
        "/me": {
            "get": {
                "operationId": "me.get",
                "summary": "Obtener la aplicación del token, su acceso y sus límites",
                "tags": [
                    "Me"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Me"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            }
        },
        "/media-imports": {
            "get": {
                "operationId": "media_imports.list",
                "summary": "Listar las descargas de fotos por dirección cambiadas desde un momento dado: pendientes, descargadas o con error",
                "tags": [
                    "MediaImports"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Tamaño de página: hasta 250 registros; 50 por defecto."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Cursor opaco: next_cursor de la página anterior, o sync_cursor de la última página guardado por la sincronización anterior. El listado va en orden de confirmación, así que el cursor de sincronización devuelve luego solo lo que cambió después de él."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Solo los registros cambiados después de este momento, ISO 8601 con zona horaria. Un filtro de la primera sincronización; después se sigue con el cursor."
                    },
                    {
                        "name": "product_id",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        },
                        "description": "Solo los registros de este producto."
                    },
                    {
                        "name": "status",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "enum": [
                                "pending",
                                "succeeded",
                                "failed"
                            ]
                        },
                        "description": "Solo las descargas en este estado."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "catalog:write"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/MediaImport"
                                            },
                                            "description": "Registros de la página."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID del registro borrado."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Cuándo se borró el registro."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Registros borrados de la base desde el cursor, como marcas de eliminación: solo con include_deleted=true en la continuación por el cursor de sincronización."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Cursor de la página siguiente; null en la última."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true si hay una página siguiente."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "En la última página — el cursor desde el que continuar más tarde: con él llega solo lo que cambió después de esta página. null en las demás."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            }
        },
        "/media-imports/{import}": {
            "get": {
                "operationId": "media_imports.get",
                "summary": "Obtener una descarga de foto por dirección",
                "tags": [
                    "MediaImports"
                ],
                "parameters": [
                    {
                        "name": "import",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID de la descarga de la foto."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "catalog:write"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/MediaImport"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            }
        },
        "/modifier-groups": {
            "get": {
                "operationId": "modifier_groups.list",
                "summary": "Listar los grupos de modificadores con opciones cambiados desde el momento indicado",
                "tags": [
                    "ModifierGroups"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Tamaño de página: hasta 250 registros; 50 por defecto."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Cursor opaco: next_cursor de la página anterior, o sync_cursor de la última página guardado por la sincronización anterior. El listado va en orden de confirmación, así que el cursor de sincronización devuelve luego solo lo que cambió después de él."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Solo los registros cambiados después de este momento, ISO 8601 con zona horaria. Un filtro de la primera sincronización; después se sigue con el cursor."
                    },
                    {
                        "name": "include_deleted",
                        "in": "query",
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "true — devolver también los registros eliminados: los archivados con deleted_at y los borrados de la base como marcas de eliminación {id, deleted_at} en la continuación por el cursor de sincronización. Activalo para sincronizar."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "catalog:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/ModifierGroup"
                                            },
                                            "description": "Registros de la página."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID del registro borrado."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Cuándo se borró el registro."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Registros borrados de la base desde el cursor, como marcas de eliminación: solo con include_deleted=true en la continuación por el cursor de sincronización."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Cursor de la página siguiente; null en la última."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true si hay una página siguiente."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "En la última página — el cursor desde el que continuar más tarde: con él llega solo lo que cambió después de esta página. null en las demás."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            },
            "post": {
                "operationId": "modifier_groups.create",
                "summary": "Crear un grupo de modificadores con opciones",
                "tags": [
                    "ModifierGroups"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/CreateModifierGroupRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "catalog:write"
                        ]
                    }
                ],
                "responses": {
                    "201": {
                        "description": "Creado",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            },
                            "Location": {
                                "$ref": "#/components/headers/Location"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ModifierGroup"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "external_id_archived",
                    "external_id_in_use",
                    "idempotency_key_in_use",
                    "record_limit_reached",
                    "idempotency_key_reused",
                    "invalid_idempotency_key"
                ]
            }
        },
        "/modifier-groups/{group}": {
            "get": {
                "operationId": "modifier_groups.get",
                "summary": "Obtener un grupo de modificadores con sus opciones",
                "tags": [
                    "ModifierGroups"
                ],
                "parameters": [
                    {
                        "name": "group",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID del grupo de modificadores."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "catalog:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ModifierGroup"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            },
            "patch": {
                "operationId": "modifier_groups.update",
                "summary": "Modificar un grupo de modificadores y su conjunto de opciones",
                "tags": [
                    "ModifierGroups"
                ],
                "parameters": [
                    {
                        "name": "group",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID del grupo de modificadores."
                    },
                    {
                        "name": "consent",
                        "in": "query",
                        "description": "Consentimientos a las consecuencias del cambio, por tipo: consent[<consent_kind>]=<consent_token> de una respuesta 409 consent_required. Conservá los consentimientos ya dados cuando se pide el tipo siguiente.",
                        "style": "deepObject",
                        "explode": true,
                        "schema": {
                            "type": "object",
                            "properties": {
                                "modifier_product_minimum": {
                                    "type": "string",
                                    "minLength": 64,
                                    "maxLength": 64,
                                    "description": "Los productos con su propia regla de elección pasan a tener un mínimo igual a la cantidad de opciones activas del grupo; si no, no se podrían comprar."
                                }
                            },
                            "additionalProperties": false
                        }
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatch"
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/UpdateModifierGroupRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "catalog:write"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ModifierGroup"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "consent_required",
                    "external_id_archived",
                    "external_id_in_use",
                    "idempotency_key_in_use",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            },
            "delete": {
                "operationId": "modifier_groups.delete",
                "summary": "Archivar un grupo de modificadores",
                "tags": [
                    "ModifierGroups"
                ],
                "parameters": [
                    {
                        "name": "group",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID del grupo de modificadores."
                    },
                    {
                        "name": "consent",
                        "in": "query",
                        "description": "Consentimientos a las consecuencias del cambio, por tipo: consent[<consent_kind>]=<consent_token> de una respuesta 409 consent_required. Conservá los consentimientos ya dados cuando se pide el tipo siguiente.",
                        "style": "deepObject",
                        "explode": true,
                        "schema": {
                            "type": "object",
                            "properties": {
                                "modifier_group_archive": {
                                    "type": "string",
                                    "minLength": 64,
                                    "maxLength": 64,
                                    "description": "Archivar el grupo lo quita de los productos, rompe la elección en los carritos de los clientes y quita sus opciones de los borradores de pedido abiertos."
                                }
                            },
                            "additionalProperties": false
                        }
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatch"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "catalog:write"
                        ]
                    }
                ],
                "responses": {
                    "204": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "consent_required",
                    "idempotency_key_in_use",
                    "in_use_conflict",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            }
        },
        "/modifier-groups/by-external-id/{external_id}": {
            "get": {
                "operationId": "modifier_groups.get_by_external_id",
                "summary": "Obtener un grupo de modificadores por ID externo",
                "tags": [
                    "ModifierGroups"
                ],
                "parameters": [
                    {
                        "name": "external_id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "ID externo: el ID del registro en tu sistema."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "catalog:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ModifierGroup"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            },
            "patch": {
                "operationId": "modifier_groups.upsert",
                "summary": "Crear o modificar un grupo de modificadores por ID externo",
                "tags": [
                    "ModifierGroups"
                ],
                "parameters": [
                    {
                        "name": "external_id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "ID externo: el ID del registro en tu sistema."
                    },
                    {
                        "name": "consent",
                        "in": "query",
                        "description": "Consentimientos a las consecuencias del cambio, por tipo: consent[<consent_kind>]=<consent_token> de una respuesta 409 consent_required. Conservá los consentimientos ya dados cuando se pide el tipo siguiente.",
                        "style": "deepObject",
                        "explode": true,
                        "schema": {
                            "type": "object",
                            "properties": {
                                "modifier_product_minimum": {
                                    "type": "string",
                                    "minLength": 64,
                                    "maxLength": 64,
                                    "description": "Los productos con su propia regla de elección pasan a tener un mínimo igual a la cantidad de opciones activas del grupo; si no, no se podrían comprar."
                                }
                            },
                            "additionalProperties": false
                        }
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatchUpsert"
                    },
                    {
                        "$ref": "#/components/parameters/IfNoneMatch"
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/UpsertModifierGroupRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "catalog:write"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ModifierGroup"
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Creado",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            },
                            "Location": {
                                "$ref": "#/components/headers/Location"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ModifierGroup"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "consent_required",
                    "external_id_archived",
                    "external_id_in_use",
                    "idempotency_key_in_use",
                    "record_limit_reached",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            }
        },
        "/money-accounts": {
            "get": {
                "operationId": "money_accounts.list",
                "summary": "Listar las cuentas de dinero de la tienda con su saldo actual: caja, banco, adquirente, billetera",
                "tags": [
                    "MoneyAccounts"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Tamaño de página: hasta 250 registros; 50 por defecto."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Cursor opaco: next_cursor de la página anterior, o sync_cursor de la última página guardado por la sincronización anterior. El listado va en orden de confirmación, así que el cursor de sincronización devuelve luego solo lo que cambió después de él."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Solo los registros cambiados después de este momento, ISO 8601 con zona horaria. Un filtro de la primera sincronización; después se sigue con el cursor."
                    },
                    {
                        "name": "include_deleted",
                        "in": "query",
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "true — devolver también los registros eliminados: los archivados con deleted_at y los borrados de la base como marcas de eliminación {id, deleted_at} en la continuación por el cursor de sincronización. Activalo para sincronizar."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "finance:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/MoneyAccount"
                                            },
                                            "description": "Registros de la página."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID del registro borrado."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Cuándo se borró el registro."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Registros borrados de la base desde el cursor, como marcas de eliminación: solo con include_deleted=true en la continuación por el cursor de sincronización."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Cursor de la página siguiente; null en la última."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true si hay una página siguiente."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "En la última página — el cursor desde el que continuar más tarde: con él llega solo lo que cambió después de esta página. null en las demás."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            }
        },
        "/money-accounts/{account}": {
            "get": {
                "operationId": "money_accounts.get",
                "summary": "Obtener una cuenta de dinero",
                "tags": [
                    "MoneyAccounts"
                ],
                "parameters": [
                    {
                        "name": "account",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID de la cuenta de dinero."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "finance:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/MoneyAccount"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            }
        },
        "/money-categories": {
            "get": {
                "operationId": "money_categories.list",
                "summary": "Listar las categorías de movimientos de dinero: el árbol de ingresos y egresos con los códigos de las categorías del sistema",
                "tags": [
                    "MoneyCategories"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Tamaño de página: hasta 250 registros; 50 por defecto."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Cursor opaco: next_cursor de la página anterior, o sync_cursor de la última página guardado por la sincronización anterior. El listado va en orden de confirmación, así que el cursor de sincronización devuelve luego solo lo que cambió después de él."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Solo los registros cambiados después de este momento, ISO 8601 con zona horaria. Un filtro de la primera sincronización; después se sigue con el cursor."
                    },
                    {
                        "name": "include_deleted",
                        "in": "query",
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "true — devolver también los registros eliminados: los archivados con deleted_at y los borrados de la base como marcas de eliminación {id, deleted_at} en la continuación por el cursor de sincronización. Activalo para sincronizar."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "finance:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/MoneyCategory"
                                            },
                                            "description": "Registros de la página."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID del registro borrado."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Cuándo se borró el registro."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Registros borrados de la base desde el cursor, como marcas de eliminación: solo con include_deleted=true en la continuación por el cursor de sincronización."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Cursor de la página siguiente; null en la última."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true si hay una página siguiente."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "En la última página — el cursor desde el que continuar más tarde: con él llega solo lo que cambió después de esta página. null en las demás."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            }
        },
        "/money-transactions": {
            "get": {
                "operationId": "money_transactions.list",
                "summary": "Listar los movimientos de dinero cambiados desde un momento: ingresos y egresos por cuenta con su origen y comprobante principal",
                "tags": [
                    "MoneyTransactions"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Tamaño de página: hasta 250 registros; 50 por defecto."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Cursor opaco: next_cursor de la página anterior, o sync_cursor de la última página guardado por la sincronización anterior. El listado va en orden de confirmación, así que el cursor de sincronización devuelve luego solo lo que cambió después de él."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Solo los registros cambiados después de este momento, ISO 8601 con zona horaria. Un filtro de la primera sincronización; después se sigue con el cursor."
                    },
                    {
                        "name": "include_deleted",
                        "in": "query",
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "true — devolver también los registros eliminados: los archivados con deleted_at y los borrados de la base como marcas de eliminación {id, deleted_at} en la continuación por el cursor de sincronización. Activalo para sincronizar."
                    },
                    {
                        "name": "account_id",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        },
                        "description": "Solo los movimientos de esta cuenta de dinero."
                    },
                    {
                        "name": "transfer_id",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        },
                        "description": "Solo las patas de esta transferencia entre cuentas."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "finance:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/MoneyTransaction"
                                            },
                                            "description": "Registros de la página."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID del registro borrado."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Cuándo se borró el registro."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Registros borrados de la base desde el cursor, como marcas de eliminación: solo con include_deleted=true en la continuación por el cursor de sincronización."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Cursor de la página siguiente; null en la última."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true si hay una página siguiente."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "En la última página — el cursor desde el que continuar más tarde: con él llega solo lo que cambió después de esta página. null en las demás."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            },
            "post": {
                "operationId": "money_transactions.create",
                "summary": "Registrar un ingreso o egreso manual en una cuenta de dinero",
                "tags": [
                    "MoneyTransactions"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/CreateMoneyTransactionRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "finance:write"
                        ]
                    }
                ],
                "responses": {
                    "201": {
                        "description": "Creado",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            },
                            "Location": {
                                "$ref": "#/components/headers/Location"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/MoneyTransaction"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "idempotency_key_reused",
                    "invalid_idempotency_key"
                ]
            }
        },
        "/money-transactions/{transaction}": {
            "get": {
                "operationId": "money_transactions.get",
                "summary": "Obtener un movimiento de dinero",
                "tags": [
                    "MoneyTransactions"
                ],
                "parameters": [
                    {
                        "name": "transaction",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID del movimiento de dinero."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "finance:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/MoneyTransaction"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            },
            "patch": {
                "operationId": "money_transactions.update",
                "summary": "Editar un movimiento de dinero: en uno con documento de origen, solo la categoría, la contraparte y la descripción",
                "tags": [
                    "MoneyTransactions"
                ],
                "parameters": [
                    {
                        "name": "transaction",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID del movimiento de dinero."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatch"
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/UpdateMoneyTransactionRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "finance:write"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/MoneyTransaction"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "money_transaction_locked",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            },
            "delete": {
                "operationId": "money_transactions.delete",
                "summary": "Borrar un movimiento manual y devolver el saldo de la cuenta",
                "tags": [
                    "MoneyTransactions"
                ],
                "parameters": [
                    {
                        "name": "transaction",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID del movimiento de dinero."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatch"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "finance:write"
                        ]
                    }
                ],
                "responses": {
                    "204": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "in_use_conflict",
                    "money_transaction_locked",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            }
        },
        "/money-transfers/{money_transfer}": {
            "get": {
                "operationId": "money_transfers.get",
                "summary": "Obtener una transferencia entre cuentas de dinero",
                "tags": [
                    "MoneyTransfers"
                ],
                "parameters": [
                    {
                        "name": "money_transfer",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID de la transferencia: el transfer_id de sus partes en el libro de movimientos de dinero."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "finance:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/MoneyTransfer"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            },
            "patch": {
                "operationId": "money_transfers.update",
                "summary": "Editar la transferencia entera en su lugar: cuentas, importes, comisión, fecha y descripción",
                "tags": [
                    "MoneyTransfers"
                ],
                "parameters": [
                    {
                        "name": "money_transfer",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID de la transferencia: el transfer_id de sus partes en el libro de movimientos de dinero."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatch"
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/UpdateMoneyTransferRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "finance:write"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/MoneyTransfer"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            },
            "delete": {
                "operationId": "money_transfers.delete",
                "summary": "Borrar una transferencia con todas sus partes",
                "tags": [
                    "MoneyTransfers"
                ],
                "parameters": [
                    {
                        "name": "money_transfer",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID de la transferencia: el transfer_id de sus partes en el libro de movimientos de dinero."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatch"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "finance:write"
                        ]
                    }
                ],
                "responses": {
                    "204": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "in_use_conflict",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            }
        },
        "/money-transfers": {
            "post": {
                "operationId": "money_transfers.create",
                "summary": "Transferir dinero entre cuentas, con comisión o sin ella",
                "tags": [
                    "MoneyTransfers"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/CreateMoneyTransferRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "finance:write"
                        ]
                    }
                ],
                "responses": {
                    "201": {
                        "description": "Creado",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            },
                            "Location": {
                                "$ref": "#/components/headers/Location"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/MoneyTransfer"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "idempotency_key_reused",
                    "invalid_idempotency_key"
                ]
            }
        },
        "/order-statuses": {
            "get": {
                "operationId": "order_statuses.list",
                "summary": "Listar los estados de pedido de la tienda y las transiciones entre ellos",
                "tags": [
                    "OrderStatuses"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Tamaño de página: hasta 250 registros; 50 por defecto."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Cursor opaco: next_cursor de la página anterior, o sync_cursor de la última página guardado por la sincronización anterior. El listado va en orden de confirmación, así que el cursor de sincronización devuelve luego solo lo que cambió después de él."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Solo los registros cambiados después de este momento, ISO 8601 con zona horaria. Un filtro de la primera sincronización; después se sigue con el cursor."
                    },
                    {
                        "name": "include_deleted",
                        "in": "query",
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "true — devolver también los registros eliminados: los archivados con deleted_at y los borrados de la base como marcas de eliminación {id, deleted_at} en la continuación por el cursor de sincronización. Activalo para sincronizar."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "orders:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/OrderStatus"
                                            },
                                            "description": "Registros de la página."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID del registro borrado."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Cuándo se borró el registro."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Registros borrados de la base desde el cursor, como marcas de eliminación: solo con include_deleted=true en la continuación por el cursor de sincronización."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Cursor de la página siguiente; null en la última."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true si hay una página siguiente."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "En la última página — el cursor desde el que continuar más tarde: con él llega solo lo que cambió después de esta página. null en las demás."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            }
        },
        "/orders": {
            "get": {
                "operationId": "orders.list",
                "summary": "Listar los pedidos cambiados desde un momento dado: ítems, totales, estado del pedido y estado del pago",
                "tags": [
                    "Orders"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Tamaño de página: hasta 250 registros; 50 por defecto."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Cursor opaco: next_cursor de la página anterior, o sync_cursor de la última página guardado por la sincronización anterior. El listado va en orden de confirmación, así que el cursor de sincronización devuelve luego solo lo que cambió después de él."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Solo los registros cambiados después de este momento, ISO 8601 con zona horaria. Un filtro de la primera sincronización; después se sigue con el cursor."
                    },
                    {
                        "name": "include_deleted",
                        "in": "query",
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "true — devolver también los registros eliminados: los archivados con deleted_at y los borrados de la base como marcas de eliminación {id, deleted_at} en la continuación por el cursor de sincronización. Activalo para sincronizar."
                    },
                    {
                        "name": "number",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 16
                        },
                        "description": "Solo el pedido con este número."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "orders:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/Order"
                                            },
                                            "description": "Registros de la página."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID del registro borrado."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Cuándo se borró el registro."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Registros borrados de la base desde el cursor, como marcas de eliminación: solo con include_deleted=true en la continuación por el cursor de sincronización."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Cursor de la página siguiente; null en la última."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true si hay una página siguiente."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "En la última página — el cursor desde el que continuar más tarde: con él llega solo lo que cambió después de esta página. null en las demás."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            }
        },
        "/orders/{order}": {
            "get": {
                "operationId": "orders.get",
                "summary": "Obtener un pedido",
                "tags": [
                    "Orders"
                ],
                "parameters": [
                    {
                        "name": "order",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID del pedido."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "orders:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Order"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            }
        },
        "/orders/{order}/shipment/label": {
            "get": {
                "operationId": "orders.get_shipment_label",
                "summary": "Descargar en PDF la etiqueta del envío actual del pedido; lleva los datos del destinatario, por eso también requiere customers:read",
                "tags": [
                    "Orders"
                ],
                "parameters": [
                    {
                        "name": "order",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID del pedido."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "orders:read",
                            "customers:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/pdf": {
                                "schema": {
                                    "type": "string",
                                    "format": "binary"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "shipment_label_unavailable",
                    "carrier_unavailable"
                ]
            }
        },
        "/orders/{order}/status": {
            "post": {
                "operationId": "orders.set_status",
                "summary": "Pasar un pedido a otro estado de la tienda",
                "tags": [
                    "Orders"
                ],
                "parameters": [
                    {
                        "name": "order",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID del pedido."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/SetOrderStatusRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "orders:write"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Order"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "order_transition_refused",
                    "idempotency_key_reused",
                    "invalid_idempotency_key"
                ]
            }
        },
        "/orders/{order}/cancel": {
            "post": {
                "operationId": "orders.cancel",
                "summary": "Cancelar un pedido",
                "tags": [
                    "Orders"
                ],
                "parameters": [
                    {
                        "name": "order",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID del pedido."
                    },
                    {
                        "name": "consent",
                        "in": "query",
                        "description": "Consentimientos a las consecuencias del cambio, por tipo: consent[<consent_kind>]=<consent_token> de una respuesta 409 consent_required. Conservá los consentimientos ya dados cuando se pide el tipo siguiente.",
                        "style": "deepObject",
                        "explode": true,
                        "schema": {
                            "type": "object",
                            "properties": {
                                "order_cancel": {
                                    "type": "string",
                                    "minLength": 64,
                                    "maxLength": 64,
                                    "description": "Cancelar el pedido devuelve el dinero recibido al cliente, a la suscripción o a la reserva, emite una nota de crédito por el comprobante fiscal, cancela el envío del transportista y deja como pérdida la mercadería ya preparada."
                                }
                            },
                            "additionalProperties": false
                        }
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/CancelOrderRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "orders:write"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Order"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "consent_required",
                    "idempotency_key_in_use",
                    "order_cancel_refused",
                    "idempotency_key_reused",
                    "invalid_idempotency_key"
                ]
            }
        },
        "/orders/{order}/shipment": {
            "post": {
                "operationId": "orders.create_shipment",
                "summary": "Emitir el envío del pedido con su transportista: la solicitud se procesa en segundo plano y el resultado aparece en el pedido y llega con order.updated",
                "tags": [
                    "Orders"
                ],
                "parameters": [
                    {
                        "name": "order",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID del pedido."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "orders:write"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Order"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Aceptado: el resultado está en la dirección de Location",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "Location": {
                                "$ref": "#/components/headers/Location"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Order"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "shipment_in_progress",
                    "shipment_outcome_unknown",
                    "shipment_refused",
                    "idempotency_key_reused",
                    "invalid_idempotency_key"
                ]
            }
        },
        "/orders/{order}/shipment/tracking": {
            "post": {
                "operationId": "orders.set_shipment_tracking",
                "summary": "Cargar el número de seguimiento de un servicio de envíos sin integración: número, enlace y nombre del servicio",
                "tags": [
                    "Orders"
                ],
                "parameters": [
                    {
                        "name": "order",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID del pedido."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/SetOrderShipmentTrackingRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "orders:write"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Order"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "shipment_in_progress",
                    "shipment_tracking_refused",
                    "idempotency_key_reused",
                    "invalid_idempotency_key"
                ]
            }
        },
        "/orders/{order}/shipment/tracking/clear": {
            "post": {
                "operationId": "orders.clear_shipment_tracking",
                "summary": "Quitar un número de seguimiento cargado a mano",
                "tags": [
                    "Orders"
                ],
                "parameters": [
                    {
                        "name": "order",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID del pedido."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "orders:write"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Order"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "shipment_in_progress",
                    "shipment_tracking_refused",
                    "idempotency_key_reused",
                    "invalid_idempotency_key"
                ]
            }
        },
        "/payments": {
            "get": {
                "operationId": "payments.list",
                "summary": "Listar los pagos de pedidos cambiados desde un momento dado",
                "tags": [
                    "Payments"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Tamaño de página: hasta 250 registros; 50 por defecto."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Cursor opaco: next_cursor de la página anterior, o sync_cursor de la última página guardado por la sincronización anterior. El listado va en orden de confirmación, así que el cursor de sincronización devuelve luego solo lo que cambió después de él."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Solo los registros cambiados después de este momento, ISO 8601 con zona horaria. Un filtro de la primera sincronización; después se sigue con el cursor."
                    },
                    {
                        "name": "include_deleted",
                        "in": "query",
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "true — devolver también los registros eliminados: los archivados con deleted_at y los borrados de la base como marcas de eliminación {id, deleted_at} en la continuación por el cursor de sincronización. Activalo para sincronizar."
                    },
                    {
                        "name": "order_id",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        },
                        "description": "Solo los registros de este pedido."
                    },
                    {
                        "name": "pos_shift_id",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        },
                        "description": "Solo los registros que recibió este turno de caja."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "payments:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/Payment"
                                            },
                                            "description": "Registros de la página."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID del registro borrado."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Cuándo se borró el registro."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Registros borrados de la base desde el cursor, como marcas de eliminación: solo con include_deleted=true en la continuación por el cursor de sincronización."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Cursor de la página siguiente; null en la última."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true si hay una página siguiente."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "En la última página — el cursor desde el que continuar más tarde: con él llega solo lo que cambió después de esta página. null en las demás."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            }
        },
        "/payments/{payment}": {
            "get": {
                "operationId": "payments.get",
                "summary": "Obtener un pago de un pedido",
                "tags": [
                    "Payments"
                ],
                "parameters": [
                    {
                        "name": "payment",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID del pago."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "payments:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Payment"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            }
        },
        "/payments/{payment}/confirm": {
            "post": {
                "operationId": "payments.confirm",
                "summary": "Confirmar que se recibió el dinero de un cobro pendiente",
                "tags": [
                    "Payments"
                ],
                "parameters": [
                    {
                        "name": "payment",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID del pago."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/ConfirmPaymentRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "payments:write"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Payment"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "payment_not_confirmable",
                    "idempotency_key_reused",
                    "invalid_idempotency_key"
                ]
            }
        },
        "/pos-cash-movements": {
            "get": {
                "operationId": "pos_cash_movements.list",
                "summary": "Diario del cajón: ventas y devoluciones en efectivo, ingresos, retiros, depósitos en la caja fuerte, cambio y anulaciones",
                "tags": [
                    "PosCashMovements"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Tamaño de página: hasta 250 registros; 50 por defecto."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Cursor opaco: next_cursor de la página anterior, o sync_cursor de la última página guardado por la sincronización anterior. El listado va en orden de confirmación, así que el cursor de sincronización devuelve luego solo lo que cambió después de él."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Solo los registros cambiados después de este momento, ISO 8601 con zona horaria. Un filtro de la primera sincronización; después se sigue con el cursor."
                    },
                    {
                        "name": "shift_id",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        },
                        "description": "Solo los movimientos de este turno de caja."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "finance:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/PosCashMovement"
                                            },
                                            "description": "Registros de la página."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID del registro borrado."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Cuándo se borró el registro."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Registros borrados de la base desde el cursor, como marcas de eliminación: solo con include_deleted=true en la continuación por el cursor de sincronización."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Cursor de la página siguiente; null en la última."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true si hay una página siguiente."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "En la última página — el cursor desde el que continuar más tarde: con él llega solo lo que cambió después de esta página. null en las demás."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            }
        },
        "/pos-cash-movements/{movement}": {
            "get": {
                "operationId": "pos_cash_movements.get",
                "summary": "Movimiento del cajón",
                "tags": [
                    "PosCashMovements"
                ],
                "parameters": [
                    {
                        "name": "movement",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID del movimiento del cajón."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "finance:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/PosCashMovement"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            }
        },
        "/pos-cash-reasons": {
            "get": {
                "operationId": "pos_cash_reasons.list",
                "summary": "Motivos de ingreso y retiro de efectivo con su categoría del libro de movimientos de dinero",
                "tags": [
                    "PosCashReasons"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Tamaño de página: hasta 250 registros; 50 por defecto."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Cursor opaco: next_cursor de la página anterior, o sync_cursor de la última página guardado por la sincronización anterior. El listado va en orden de confirmación, así que el cursor de sincronización devuelve luego solo lo que cambió después de él."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Solo los registros cambiados después de este momento, ISO 8601 con zona horaria. Un filtro de la primera sincronización; después se sigue con el cursor."
                    },
                    {
                        "name": "include_deleted",
                        "in": "query",
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "true — devolver también los registros eliminados: los archivados con deleted_at y los borrados de la base como marcas de eliminación {id, deleted_at} en la continuación por el cursor de sincronización. Activalo para sincronizar."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "finance:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/PosCashReason"
                                            },
                                            "description": "Registros de la página."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID del registro borrado."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Cuándo se borró el registro."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Registros borrados de la base desde el cursor, como marcas de eliminación: solo con include_deleted=true en la continuación por el cursor de sincronización."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Cursor de la página siguiente; null en la última."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true si hay una página siguiente."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "En la última página — el cursor desde el que continuar más tarde: con él llega solo lo que cambió después de esta página. null en las demás."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            }
        },
        "/pos-shifts": {
            "get": {
                "operationId": "pos_shifts.list",
                "summary": "Turnos de caja modificados desde un momento dado: arqueo del cajón en cada moneda",
                "tags": [
                    "PosShifts"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Tamaño de página: hasta 250 registros; 50 por defecto."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Cursor opaco: next_cursor de la página anterior, o sync_cursor de la última página guardado por la sincronización anterior. El listado va en orden de confirmación, así que el cursor de sincronización devuelve luego solo lo que cambió después de él."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Solo los registros cambiados después de este momento, ISO 8601 con zona horaria. Un filtro de la primera sincronización; después se sigue con el cursor."
                    },
                    {
                        "name": "include_deleted",
                        "in": "query",
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "true — devolver también los registros eliminados: los archivados con deleted_at y los borrados de la base como marcas de eliminación {id, deleted_at} en la continuación por el cursor de sincronización. Activalo para sincronizar."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "finance:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/PosShift"
                                            },
                                            "description": "Registros de la página."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID del registro borrado."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Cuándo se borró el registro."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Registros borrados de la base desde el cursor, como marcas de eliminación: solo con include_deleted=true en la continuación por el cursor de sincronización."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Cursor de la página siguiente; null en la última."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true si hay una página siguiente."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "En la última página — el cursor desde el que continuar más tarde: con él llega solo lo que cambió después de esta página. null en las demás."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            }
        },
        "/pos-shifts/{shift}": {
            "get": {
                "operationId": "pos_shifts.get",
                "summary": "Turno de caja",
                "tags": [
                    "PosShifts"
                ],
                "parameters": [
                    {
                        "name": "shift",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID del turno de caja."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "finance:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/PosShift"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            }
        },
        "/price-list-items": {
            "get": {
                "operationId": "price_list_items.list",
                "summary": "Listar los precios fijos de variantes en listas de precios modificados desde un momento dado",
                "tags": [
                    "PriceListItems"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Tamaño de página: hasta 250 registros; 50 por defecto."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Cursor opaco: next_cursor de la página anterior, o sync_cursor de la última página guardado por la sincronización anterior. El listado va en orden de confirmación, así que el cursor de sincronización devuelve luego solo lo que cambió después de él."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Solo los registros cambiados después de este momento, ISO 8601 con zona horaria. Un filtro de la primera sincronización; después se sigue con el cursor."
                    },
                    {
                        "name": "include_deleted",
                        "in": "query",
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "true — devolver también los registros eliminados: los archivados con deleted_at y los borrados de la base como marcas de eliminación {id, deleted_at} en la continuación por el cursor de sincronización. Activalo para sincronizar."
                    },
                    {
                        "name": "price_list_id",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        },
                        "description": "Solo precios de esta lista."
                    },
                    {
                        "name": "variant_id",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        },
                        "description": "Solo precios de esta variante en todas las listas."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "catalog:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/PriceListItem"
                                            },
                                            "description": "Registros de la página."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID del registro borrado."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Cuándo se borró el registro."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Registros borrados de la base desde el cursor, como marcas de eliminación: solo con include_deleted=true en la continuación por el cursor de sincronización."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Cursor de la página siguiente; null en la última."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true si hay una página siguiente."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "En la última página — el cursor desde el que continuar más tarde: con él llega solo lo que cambió después de esta página. null en las demás."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            }
        },
        "/price-list-items/{price_list_item}": {
            "get": {
                "operationId": "price_list_items.get",
                "summary": "Obtener un precio fijo de variante en una lista de precios",
                "tags": [
                    "PriceListItems"
                ],
                "parameters": [
                    {
                        "name": "price_list_item",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID del precio fijo de la lista."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "catalog:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/PriceListItem"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            }
        },
        "/price-lists/{price_list}/items": {
            "post": {
                "operationId": "price_lists.set_items",
                "summary": "Fijar precios de variantes en una lista de precios, en lote",
                "tags": [
                    "PriceListItems"
                ],
                "parameters": [
                    {
                        "name": "price_list",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "ID de la lista de precios."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatch"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/SetPriceListItemsRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "catalog:write"
                        ]
                    },
                    {
                        "apiToken": [
                            "orders:wholesale"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/PriceList"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            }
        },
        "/price-lists/{price_list}/items/remove": {
            "post": {
                "operationId": "price_lists.remove_items",
                "summary": "Quitar precios fijos de variantes de una lista de precios, en lote",
                "tags": [
                    "PriceListItems"
                ],
                "parameters": [
                    {
                        "name": "price_list",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "ID de la lista de precios."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatch"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/RemovePriceListItemsRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "catalog:write"
                        ]
                    },
                    {
                        "apiToken": [
                            "orders:wholesale"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/PriceList"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            }
        },
        "/price-list-modifier-items": {
            "get": {
                "operationId": "price_list_modifier_items.list",
                "summary": "Listar los recargos fijos de opciones de modificadores en listas de precios modificados desde un momento dado",
                "tags": [
                    "PriceListModifierItems"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Tamaño de página: hasta 250 registros; 50 por defecto."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Cursor opaco: next_cursor de la página anterior, o sync_cursor de la última página guardado por la sincronización anterior. El listado va en orden de confirmación, así que el cursor de sincronización devuelve luego solo lo que cambió después de él."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Solo los registros cambiados después de este momento, ISO 8601 con zona horaria. Un filtro de la primera sincronización; después se sigue con el cursor."
                    },
                    {
                        "name": "include_deleted",
                        "in": "query",
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "true — devolver también los registros eliminados: los archivados con deleted_at y los borrados de la base como marcas de eliminación {id, deleted_at} en la continuación por el cursor de sincronización. Activalo para sincronizar."
                    },
                    {
                        "name": "price_list_id",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        },
                        "description": "Solo recargos de esta lista."
                    },
                    {
                        "name": "modifier_option_id",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        },
                        "description": "Solo recargos de esta opción en todas las listas."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "catalog:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/PriceListModifierItem"
                                            },
                                            "description": "Registros de la página."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID del registro borrado."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Cuándo se borró el registro."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Registros borrados de la base desde el cursor, como marcas de eliminación: solo con include_deleted=true en la continuación por el cursor de sincronización."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Cursor de la página siguiente; null en la última."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true si hay una página siguiente."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "En la última página — el cursor desde el que continuar más tarde: con él llega solo lo que cambió después de esta página. null en las demás."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            }
        },
        "/price-list-modifier-items/{price_list_modifier_item}": {
            "get": {
                "operationId": "price_list_modifier_items.get",
                "summary": "Obtener un recargo fijo de opción en una lista de precios",
                "tags": [
                    "PriceListModifierItems"
                ],
                "parameters": [
                    {
                        "name": "price_list_modifier_item",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID del recargo fijo de la lista."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "catalog:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/PriceListModifierItem"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            }
        },
        "/price-lists/{price_list}/modifier-items": {
            "post": {
                "operationId": "price_lists.set_modifier_items",
                "summary": "Fijar recargos de opciones de modificadores en una lista de precios, en lote",
                "tags": [
                    "PriceListModifierItems"
                ],
                "parameters": [
                    {
                        "name": "price_list",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "ID de la lista de precios."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatch"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/SetPriceListModifierItemsRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "catalog:write"
                        ]
                    },
                    {
                        "apiToken": [
                            "orders:wholesale"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/PriceList"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            }
        },
        "/price-lists/{price_list}/modifier-items/remove": {
            "post": {
                "operationId": "price_lists.remove_modifier_items",
                "summary": "Quitar recargos fijos de opciones de una lista de precios, en lote",
                "tags": [
                    "PriceListModifierItems"
                ],
                "parameters": [
                    {
                        "name": "price_list",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "ID de la lista de precios."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatch"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/RemovePriceListModifierItemsRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "catalog:write"
                        ]
                    },
                    {
                        "apiToken": [
                            "orders:wholesale"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/PriceList"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            }
        },
        "/price-lists": {
            "get": {
                "operationId": "price_lists.list",
                "summary": "Listar las listas de precios de la tienda: de local y mayoristas, con su regla y redondeo",
                "tags": [
                    "PriceLists"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Tamaño de página: hasta 250 registros; 50 por defecto."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Cursor opaco: next_cursor de la página anterior, o sync_cursor de la última página guardado por la sincronización anterior. El listado va en orden de confirmación, así que el cursor de sincronización devuelve luego solo lo que cambió después de él."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Solo los registros cambiados después de este momento, ISO 8601 con zona horaria. Un filtro de la primera sincronización; después se sigue con el cursor."
                    },
                    {
                        "name": "include_deleted",
                        "in": "query",
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "true — devolver también los registros eliminados: los archivados con deleted_at y los borrados de la base como marcas de eliminación {id, deleted_at} en la continuación por el cursor de sincronización. Activalo para sincronizar."
                    },
                    {
                        "name": "kind",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "enum": [
                                "location",
                                "wholesale"
                            ]
                        },
                        "description": "Solo listas de este tipo: location — listas de local, wholesale — mayoristas."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "catalog:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/PriceList"
                                            },
                                            "description": "Registros de la página."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID del registro borrado."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Cuándo se borró el registro."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Registros borrados de la base desde el cursor, como marcas de eliminación: solo con include_deleted=true en la continuación por el cursor de sincronización."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Cursor de la página siguiente; null en la última."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true si hay una página siguiente."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "En la última página — el cursor desde el que continuar más tarde: con él llega solo lo que cambió después de esta página. null en las demás."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            },
            "post": {
                "operationId": "price_lists.create",
                "summary": "Crear una lista de precios mayorista",
                "tags": [
                    "PriceLists"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/CreatePriceListRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "orders:wholesale"
                        ]
                    }
                ],
                "responses": {
                    "201": {
                        "description": "Creado",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            },
                            "Location": {
                                "$ref": "#/components/headers/Location"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/PriceList"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "idempotency_key_reused",
                    "invalid_idempotency_key"
                ]
            }
        },
        "/price-lists/{price_list}": {
            "get": {
                "operationId": "price_lists.get",
                "summary": "Obtener una lista de precios",
                "tags": [
                    "PriceLists"
                ],
                "parameters": [
                    {
                        "name": "price_list",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID de la lista de precios."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "catalog:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/PriceList"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            },
            "patch": {
                "operationId": "price_lists.update",
                "summary": "Cambiar una lista de precios: ajuste y redondeo, y el nombre de una mayorista; la regla de una lista de local cambia los precios en todos sus locales",
                "tags": [
                    "PriceLists"
                ],
                "parameters": [
                    {
                        "name": "price_list",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "ID de la lista de precios."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatch"
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/UpdatePriceListRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "catalog:write"
                        ]
                    },
                    {
                        "apiToken": [
                            "orders:wholesale"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/PriceList"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            },
            "delete": {
                "operationId": "price_lists.delete",
                "summary": "Borrar una lista de precios mayorista; su asignación a clientes se quita con consentimiento",
                "tags": [
                    "PriceLists"
                ],
                "parameters": [
                    {
                        "name": "price_list",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "ID de la lista de precios."
                    },
                    {
                        "name": "consent",
                        "in": "query",
                        "description": "Consentimientos a las consecuencias del cambio, por tipo: consent[<consent_kind>]=<consent_token> de una respuesta 409 consent_required. Conservá los consentimientos ya dados cuando se pide el tipo siguiente.",
                        "style": "deepObject",
                        "explode": true,
                        "schema": {
                            "type": "object",
                            "properties": {
                                "wholesale_price_list_buyers": {
                                    "type": "string",
                                    "minLength": 64,
                                    "maxLength": 64,
                                    "description": "La lista mayorista está asignada a clientes: borrarla quita la asignación y sus ventas mayoristas pasan a precios base. buyers — a cuántos clientes afecta."
                                }
                            },
                            "additionalProperties": false
                        }
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatch"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "orders:wholesale"
                        ]
                    }
                ],
                "responses": {
                    "204": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "consent_required",
                    "idempotency_key_in_use",
                    "in_use_conflict",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            }
        },
        "/products/{product}/media/{media}": {
            "get": {
                "operationId": "product_media.get",
                "summary": "Obtener una foto de la galería del producto",
                "tags": [
                    "ProductMedia"
                ],
                "parameters": [
                    {
                        "name": "product",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID del producto."
                    },
                    {
                        "name": "media",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID de la foto: el id en media del producto."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "catalog:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ProductMedia"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            },
            "patch": {
                "operationId": "product_media.update",
                "summary": "Mover una foto de la galería o marcarla como principal",
                "tags": [
                    "ProductMedia"
                ],
                "parameters": [
                    {
                        "name": "product",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID del producto."
                    },
                    {
                        "name": "media",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID de la foto: el id en media del producto."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatch"
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/UpdateProductMediaRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "catalog:write"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ProductMedia"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            },
            "delete": {
                "operationId": "product_media.delete",
                "summary": "Quitar una foto de la galería del producto",
                "tags": [
                    "ProductMedia"
                ],
                "parameters": [
                    {
                        "name": "product",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID del producto."
                    },
                    {
                        "name": "media",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID de la foto: el id en media del producto."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatch"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "catalog:write"
                        ]
                    }
                ],
                "responses": {
                    "204": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "in_use_conflict",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            }
        },
        "/products/{product}/media": {
            "post": {
                "operationId": "product_media.create",
                "summary": "Agregar una foto a la galería del producto desde la dirección de una imagen",
                "tags": [
                    "ProductMedia"
                ],
                "parameters": [
                    {
                        "name": "product",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID del producto."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/CreateProductMediaRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "catalog:write"
                        ]
                    }
                ],
                "responses": {
                    "202": {
                        "description": "Aceptado: el resultado está en la dirección de Location",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "Location": {
                                "$ref": "#/components/headers/Location"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/MediaImport"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "idempotency_key_reused",
                    "invalid_idempotency_key"
                ]
            }
        },
        "/products/{product}/modifier-groups": {
            "get": {
                "operationId": "products.get_modifier_groups",
                "summary": "Obtener los grupos de modificadores del producto y los recargos de sus opciones por variante",
                "tags": [
                    "ProductModifierGroups"
                ],
                "parameters": [
                    {
                        "name": "product",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID del producto."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "catalog:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ProductModifierGroups"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            },
            "put": {
                "operationId": "products.replace_modifier_groups",
                "summary": "Reemplazar los grupos de modificadores del producto y los recargos de sus opciones por variante",
                "tags": [
                    "ProductModifierGroups"
                ],
                "parameters": [
                    {
                        "name": "product",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID del producto."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatch"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/ReplaceProductModifierGroupsRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "catalog:write"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ProductModifierGroups"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            }
        },
        "/products": {
            "get": {
                "operationId": "products.list",
                "summary": "Listar los productos: categorías, opciones y fotos, sin variantes",
                "tags": [
                    "Products"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Tamaño de página: hasta 250 registros; 50 por defecto."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Cursor opaco: next_cursor de la página anterior, o sync_cursor de la última página guardado por la sincronización anterior. El listado va en orden de confirmación, así que el cursor de sincronización devuelve luego solo lo que cambió después de él."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Solo los registros cambiados después de este momento, ISO 8601 con zona horaria. Un filtro de la primera sincronización; después se sigue con el cursor."
                    },
                    {
                        "name": "include_deleted",
                        "in": "query",
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "true — devolver también los registros eliminados: los archivados con deleted_at y los borrados de la base como marcas de eliminación {id, deleted_at} en la continuación por el cursor de sincronización. Activalo para sincronizar."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "catalog:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/Product"
                                            },
                                            "description": "Registros de la página."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID del registro borrado."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Cuándo se borró el registro."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Registros borrados de la base desde el cursor, como marcas de eliminación: solo con include_deleted=true en la continuación por el cursor de sincronización."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Cursor de la página siguiente; null en la última."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true si hay una página siguiente."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "En la última página — el cursor desde el que continuar más tarde: con él llega solo lo que cambió después de esta página. null en las demás."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            },
            "post": {
                "operationId": "products.create",
                "summary": "Crear un producto con sus variantes",
                "tags": [
                    "Products"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/CreateProductRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "catalog:write"
                        ]
                    }
                ],
                "responses": {
                    "201": {
                        "description": "Creado",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            },
                            "Location": {
                                "$ref": "#/components/headers/Location"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Product"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "external_id_archived",
                    "external_id_in_use",
                    "idempotency_key_in_use",
                    "plan_limit_reached",
                    "idempotency_key_reused",
                    "invalid_idempotency_key"
                ]
            }
        },
        "/products/{product}": {
            "get": {
                "operationId": "products.get",
                "summary": "Obtener un producto",
                "tags": [
                    "Products"
                ],
                "parameters": [
                    {
                        "name": "product",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID del producto."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "catalog:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Product"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            },
            "patch": {
                "operationId": "products.update",
                "summary": "Modificar la ficha de un producto: campos, categorías, ID externo",
                "tags": [
                    "Products"
                ],
                "parameters": [
                    {
                        "name": "product",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID del producto."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatch"
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/UpdateProductRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "catalog:write"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Product"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "consent_required",
                    "external_id_archived",
                    "external_id_in_use",
                    "idempotency_key_in_use",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            },
            "delete": {
                "operationId": "products.delete",
                "summary": "Archivar un producto con sus variantes",
                "tags": [
                    "Products"
                ],
                "parameters": [
                    {
                        "name": "product",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID del producto."
                    },
                    {
                        "name": "consent",
                        "in": "query",
                        "description": "Consentimientos a las consecuencias del cambio, por tipo: consent[<consent_kind>]=<consent_token> de una respuesta 409 consent_required. Conservá los consentimientos ya dados cuando se pide el tipo siguiente.",
                        "style": "deepObject",
                        "explode": true,
                        "schema": {
                            "type": "object",
                            "properties": {
                                "recipe_ingredient": {
                                    "type": "string",
                                    "minLength": 64,
                                    "maxLength": 64,
                                    "description": "El producto es ingrediente de recetas vigentes y sale de ellas."
                                },
                                "production_draft": {
                                    "type": "string",
                                    "minLength": 64,
                                    "maxLength": 64,
                                    "description": "Se cancelan los borradores de actas de producción con el producto."
                                },
                                "program_menu": {
                                    "type": "string",
                                    "minLength": 64,
                                    "maxLength": 64,
                                    "description": "El plato sale de los menús de los planes de comidas por suscripción."
                                },
                                "live_subscriptions": {
                                    "type": "string",
                                    "minLength": 64,
                                    "maxLength": 64,
                                    "description": "El plan con suscripciones vigentes sale de la venta."
                                }
                            },
                            "additionalProperties": false
                        }
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatch"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "catalog:write"
                        ]
                    }
                ],
                "responses": {
                    "204": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "consent_required",
                    "idempotency_key_in_use",
                    "in_use_conflict",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            }
        },
        "/products/by-external-id/{external_id}": {
            "get": {
                "operationId": "products.get_by_external_id",
                "summary": "Obtener un producto por su ID externo",
                "tags": [
                    "Products"
                ],
                "parameters": [
                    {
                        "name": "external_id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "ID externo: el ID del registro en tu sistema."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "catalog:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Product"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            },
            "patch": {
                "operationId": "products.upsert",
                "summary": "Crear o modificar un producto con sus variantes por su ID en la app",
                "tags": [
                    "Products"
                ],
                "parameters": [
                    {
                        "name": "external_id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "ID externo: el ID del registro en tu sistema."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatchUpsert"
                    },
                    {
                        "$ref": "#/components/parameters/IfNoneMatch"
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/UpsertProductRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "catalog:write"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Product"
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Creado",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            },
                            "Location": {
                                "$ref": "#/components/headers/Location"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Product"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "consent_required",
                    "external_id_archived",
                    "external_id_in_use",
                    "idempotency_key_in_use",
                    "plan_limit_reached",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            }
        },
        "/products/{product}/options": {
            "put": {
                "operationId": "products.replace_options",
                "summary": "Reemplazar las opciones del producto y distribuir sus variantes",
                "tags": [
                    "Products"
                ],
                "parameters": [
                    {
                        "name": "product",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID del producto."
                    },
                    {
                        "name": "consent",
                        "in": "query",
                        "description": "Consentimientos a las consecuencias del cambio, por tipo: consent[<consent_kind>]=<consent_token> de una respuesta 409 consent_required. Conservá los consentimientos ya dados cuando se pide el tipo siguiente.",
                        "style": "deepObject",
                        "explode": true,
                        "schema": {
                            "type": "object",
                            "properties": {
                                "variant_axes": {
                                    "type": "string",
                                    "minLength": 64,
                                    "maxLength": 64,
                                    "description": "Las variantes con la misma combinación se fusionan, y las indicadas para archivar se archivan junto con sus dependencias."
                                }
                            },
                            "additionalProperties": false
                        }
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatch"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/ReplaceProductOptionsRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "catalog:write"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Product"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "consent_required",
                    "idempotency_key_in_use",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            }
        },
        "/purchase-orders": {
            "get": {
                "operationId": "purchase_orders.list",
                "summary": "Órdenes de compra: lo pedido, lo confirmado por el proveedor y lo recibido por línea",
                "tags": [
                    "PurchaseOrders"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Tamaño de página: hasta 250 registros; 50 por defecto."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Cursor opaco: next_cursor de la página anterior, o sync_cursor de la última página guardado por la sincronización anterior. El listado va en orden de confirmación, así que el cursor de sincronización devuelve luego solo lo que cambió después de él."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Solo los registros cambiados después de este momento, ISO 8601 con zona horaria. Un filtro de la primera sincronización; después se sigue con el cursor."
                    },
                    {
                        "name": "include_deleted",
                        "in": "query",
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "true — devolver también los registros eliminados: los archivados con deleted_at y los borrados de la base como marcas de eliminación {id, deleted_at} en la continuación por el cursor de sincronización. Activalo para sincronizar."
                    },
                    {
                        "name": "supplier_id",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        },
                        "description": "Solo documentos de este proveedor."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "procurement:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/PurchaseOrder"
                                            },
                                            "description": "Registros de la página."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID del registro borrado."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Cuándo se borró el registro."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Registros borrados de la base desde el cursor, como marcas de eliminación: solo con include_deleted=true en la continuación por el cursor de sincronización."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Cursor de la página siguiente; null en la última."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true si hay una página siguiente."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "En la última página — el cursor desde el que continuar más tarde: con él llega solo lo que cambió después de esta página. null en las demás."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            },
            "post": {
                "operationId": "purchase_orders.create",
                "summary": "Crear un borrador de orden de compra",
                "tags": [
                    "PurchaseOrders"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/CreatePurchaseOrderRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "procurement:write"
                        ]
                    }
                ],
                "responses": {
                    "201": {
                        "description": "Creado",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            },
                            "Location": {
                                "$ref": "#/components/headers/Location"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/PurchaseOrder"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "capability_disabled",
                    "idempotency_key_in_use",
                    "idempotency_key_reused",
                    "invalid_idempotency_key"
                ]
            }
        },
        "/purchase-orders/{purchase_order}": {
            "get": {
                "operationId": "purchase_orders.get",
                "summary": "Orden de compra",
                "tags": [
                    "PurchaseOrders"
                ],
                "parameters": [
                    {
                        "name": "purchase_order",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID de la orden de compra."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "procurement:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/PurchaseOrder"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            },
            "patch": {
                "operationId": "purchase_orders.update",
                "summary": "Cambiar una orden de compra: el borrador entero; de la colocada, las líneas, la fecha y la nota con revisión",
                "tags": [
                    "PurchaseOrders"
                ],
                "parameters": [
                    {
                        "name": "purchase_order",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID de la orden de compra."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatch"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "procurement:write"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/PurchaseOrder"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "capability_disabled",
                    "idempotency_key_in_use",
                    "purchase_order_refused",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            },
            "delete": {
                "operationId": "purchase_orders.delete",
                "summary": "Borrar un borrador de orden de compra",
                "tags": [
                    "PurchaseOrders"
                ],
                "parameters": [
                    {
                        "name": "purchase_order",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID de la orden de compra."
                    },
                    {
                        "name": "consent",
                        "in": "query",
                        "description": "Consentimientos a las consecuencias del cambio, por tipo: consent[<consent_kind>]=<consent_token> de una respuesta 409 consent_required. Conservá los consentimientos ya dados cuando se pide el tipo siguiente.",
                        "style": "deepObject",
                        "explode": true,
                        "schema": {
                            "type": "object",
                            "properties": {
                                "purchase_order_follow_up": {
                                    "type": "string",
                                    "minLength": 64,
                                    "maxLength": 64,
                                    "description": "El borrador es un pedido complementario de la decisión «comprar a otro» en la respuesta del proveedor a otra orden: borrarlo retira esa decisión y la diferencia de la orden de origen vuelve a esperar una decisión. source_orders cuenta las órdenes de origen afectadas."
                                }
                            },
                            "additionalProperties": false
                        }
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatch"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "procurement:write"
                        ]
                    }
                ],
                "responses": {
                    "204": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "capability_disabled",
                    "consent_required",
                    "idempotency_key_in_use",
                    "in_use_conflict",
                    "purchase_order_refused",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            }
        },
        "/purchase-orders/{purchase_order}/place": {
            "post": {
                "operationId": "purchase_orders.place",
                "summary": "Marcar el borrador como colocado con el proveedor",
                "tags": [
                    "PurchaseOrders"
                ],
                "parameters": [
                    {
                        "name": "purchase_order",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID de la orden de compra."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatch"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "procurement:write"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/PurchaseOrder"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "capability_disabled",
                    "idempotency_key_in_use",
                    "purchase_order_refused",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            }
        },
        "/purchase-orders/{purchase_order}/cancel": {
            "post": {
                "operationId": "purchase_orders.cancel",
                "summary": "Cancelar una orden de compra colocada",
                "tags": [
                    "PurchaseOrders"
                ],
                "parameters": [
                    {
                        "name": "purchase_order",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID de la orden de compra."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatch"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "procurement:write"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/PurchaseOrder"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "capability_disabled",
                    "idempotency_key_in_use",
                    "purchase_order_refused",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            }
        },
        "/purchase-orders/{purchase_order}/close": {
            "post": {
                "operationId": "purchase_orders.close",
                "summary": "Cerrar una orden de compra recibida",
                "tags": [
                    "PurchaseOrders"
                ],
                "parameters": [
                    {
                        "name": "purchase_order",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID de la orden de compra."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatch"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "procurement:write"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/PurchaseOrder"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "capability_disabled",
                    "idempotency_key_in_use",
                    "purchase_order_refused",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            }
        },
        "/recommendation-rules": {
            "get": {
                "operationId": "recommendation_rules.list",
                "summary": "Listar las reglas de recomendaciones cambiadas desde un momento dado",
                "tags": [
                    "RecommendationRules"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Tamaño de página: hasta 250 registros; 50 por defecto."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Cursor opaco: next_cursor de la página anterior, o sync_cursor de la última página guardado por la sincronización anterior. El listado va en orden de confirmación, así que el cursor de sincronización devuelve luego solo lo que cambió después de él."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Solo los registros cambiados después de este momento, ISO 8601 con zona horaria. Un filtro de la primera sincronización; después se sigue con el cursor."
                    },
                    {
                        "name": "include_deleted",
                        "in": "query",
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "true — devolver también los registros eliminados: los archivados con deleted_at y los borrados de la base como marcas de eliminación {id, deleted_at} en la continuación por el cursor de sincronización. Activalo para sincronizar."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "catalog:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/RecommendationRule"
                                            },
                                            "description": "Registros de la página."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID del registro borrado."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Cuándo se borró el registro."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Registros borrados de la base desde el cursor, como marcas de eliminación: solo con include_deleted=true en la continuación por el cursor de sincronización."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Cursor de la página siguiente; null en la última."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true si hay una página siguiente."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "En la última página — el cursor desde el que continuar más tarde: con él llega solo lo que cambió después de esta página. null en las demás."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            },
            "post": {
                "operationId": "recommendation_rules.create",
                "summary": "Crear una regla de recomendaciones",
                "tags": [
                    "RecommendationRules"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/CreateRecommendationRuleRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "catalog:write"
                        ]
                    }
                ],
                "responses": {
                    "201": {
                        "description": "Creado",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            },
                            "Location": {
                                "$ref": "#/components/headers/Location"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/RecommendationRule"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "record_limit_reached",
                    "idempotency_key_reused",
                    "invalid_idempotency_key"
                ]
            }
        },
        "/recommendation-rules/{rule}": {
            "get": {
                "operationId": "recommendation_rules.get",
                "summary": "Obtener una regla de recomendaciones",
                "tags": [
                    "RecommendationRules"
                ],
                "parameters": [
                    {
                        "name": "rule",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID de la regla de recomendaciones."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "catalog:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/RecommendationRule"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            },
            "patch": {
                "operationId": "recommendation_rules.update",
                "summary": "Cambiar una regla de recomendaciones",
                "tags": [
                    "RecommendationRules"
                ],
                "parameters": [
                    {
                        "name": "rule",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID de la regla de recomendaciones."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatch"
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/UpdateRecommendationRuleRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "catalog:write"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/RecommendationRule"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            },
            "delete": {
                "operationId": "recommendation_rules.delete",
                "summary": "Eliminar una regla de recomendaciones",
                "tags": [
                    "RecommendationRules"
                ],
                "parameters": [
                    {
                        "name": "rule",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID de la regla de recomendaciones."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatch"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "catalog:write"
                        ]
                    }
                ],
                "responses": {
                    "204": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "in_use_conflict",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            }
        },
        "/refunds": {
            "get": {
                "operationId": "refunds.list",
                "summary": "Listar las devoluciones de pedidos cambiadas desde un momento dado: ítems y movimientos por pago",
                "tags": [
                    "Refunds"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Tamaño de página: hasta 250 registros; 50 por defecto."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Cursor opaco: next_cursor de la página anterior, o sync_cursor de la última página guardado por la sincronización anterior. El listado va en orden de confirmación, así que el cursor de sincronización devuelve luego solo lo que cambió después de él."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Solo los registros cambiados después de este momento, ISO 8601 con zona horaria. Un filtro de la primera sincronización; después se sigue con el cursor."
                    },
                    {
                        "name": "include_deleted",
                        "in": "query",
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "true — devolver también los registros eliminados: los archivados con deleted_at y los borrados de la base como marcas de eliminación {id, deleted_at} en la continuación por el cursor de sincronización. Activalo para sincronizar."
                    },
                    {
                        "name": "order_id",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        },
                        "description": "Solo los registros de este pedido."
                    },
                    {
                        "name": "pos_shift_id",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        },
                        "description": "Solo los registros que recibió este turno de caja."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "refunds:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/Refund"
                                            },
                                            "description": "Registros de la página."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID del registro borrado."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Cuándo se borró el registro."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Registros borrados de la base desde el cursor, como marcas de eliminación: solo con include_deleted=true en la continuación por el cursor de sincronización."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Cursor de la página siguiente; null en la última."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true si hay una página siguiente."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "En la última página — el cursor desde el que continuar más tarde: con él llega solo lo que cambió después de esta página. null en las demás."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            }
        },
        "/refunds/{refund}": {
            "get": {
                "operationId": "refunds.get",
                "summary": "Obtener una devolución de un pedido",
                "tags": [
                    "Refunds"
                ],
                "parameters": [
                    {
                        "name": "refund",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID del reembolso."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "refunds:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Refund"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            }
        },
        "/orders/{order}/refunds/calculate": {
            "post": {
                "operationId": "refunds.calculate",
                "summary": "Calcular la devolución de un pedido y lo que queda por devolver, sin escribir nada",
                "tags": [
                    "Refunds"
                ],
                "parameters": [
                    {
                        "name": "order",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID del pedido."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/CalculateRefundRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "refunds:write"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/RefundCalculation"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "refund_refused",
                    "idempotency_key_reused",
                    "invalid_idempotency_key"
                ]
            }
        },
        "/orders/{order}/refunds": {
            "post": {
                "operationId": "refunds.create",
                "summary": "Devolver ítems y envío de un pedido: el dinero vuelve por los medios de pago, la mercadería al stock",
                "tags": [
                    "Refunds"
                ],
                "parameters": [
                    {
                        "name": "order",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID del pedido."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/CreateRefundRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "refunds:write"
                        ]
                    }
                ],
                "responses": {
                    "201": {
                        "description": "Creado",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Refund"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "refund_refused",
                    "idempotency_key_reused",
                    "invalid_idempotency_key"
                ]
            }
        },
        "/refunds/{refund}/confirm": {
            "post": {
                "operationId": "refunds.confirm",
                "summary": "Confirmar que el dinero de la devolución se reintegró fuera del sistema",
                "tags": [
                    "Refunds"
                ],
                "parameters": [
                    {
                        "name": "refund",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID del reembolso."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "refunds:write"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Refund"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "refund_not_confirmable",
                    "idempotency_key_reused",
                    "invalid_idempotency_key"
                ]
            }
        },
        "/settlement-agreements": {
            "get": {
                "operationId": "settlement_agreements.list",
                "summary": "Acuerdos de compensación: partes, tipo, datos del contrato, vigencia y calendario",
                "tags": [
                    "SettlementAgreements"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Tamaño de página: hasta 250 registros; 50 por defecto."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Cursor opaco: next_cursor de la página anterior, o sync_cursor de la última página guardado por la sincronización anterior. El listado va en orden de confirmación, así que el cursor de sincronización devuelve luego solo lo que cambió después de él."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Solo los registros cambiados después de este momento, ISO 8601 con zona horaria. Un filtro de la primera sincronización; después se sigue con el cursor."
                    },
                    {
                        "name": "include_deleted",
                        "in": "query",
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "true — devolver también los registros eliminados: los archivados con deleted_at y los borrados de la base como marcas de eliminación {id, deleted_at} en la continuación por el cursor de sincronización. Activalo para sincronizar."
                    },
                    {
                        "name": "supplier_id",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        },
                        "description": "Solo documentos de este proveedor."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "procurement:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/SettlementAgreement"
                                            },
                                            "description": "Registros de la página."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID del registro borrado."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Cuándo se borró el registro."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Registros borrados de la base desde el cursor, como marcas de eliminación: solo con include_deleted=true en la continuación por el cursor de sincronización."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Cursor de la página siguiente; null en la última."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true si hay una página siguiente."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "En la última página — el cursor desde el que continuar más tarde: con él llega solo lo que cambió después de esta página. null en las demás."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            }
        },
        "/settlement-agreements/{settlement_agreement}": {
            "get": {
                "operationId": "settlement_agreements.get",
                "summary": "Acuerdo de compensación",
                "tags": [
                    "SettlementAgreements"
                ],
                "parameters": [
                    {
                        "name": "settlement_agreement",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID del acuerdo de compensación."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "procurement:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/SettlementAgreement"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            }
        },
        "/settlement-offset-lines": {
            "get": {
                "operationId": "settlement_offset_lines.list",
                "summary": "Líneas de compensaciones: deudas del cliente y comprobantes de proveedores compensados",
                "tags": [
                    "SettlementOffsetLines"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Tamaño de página: hasta 250 registros; 50 por defecto."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Cursor opaco: next_cursor de la página anterior, o sync_cursor de la última página guardado por la sincronización anterior. El listado va en orden de confirmación, así que el cursor de sincronización devuelve luego solo lo que cambió después de él."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Solo los registros cambiados después de este momento, ISO 8601 con zona horaria. Un filtro de la primera sincronización; después se sigue con el cursor."
                    },
                    {
                        "name": "settlement_offset_id",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        },
                        "description": "Solo líneas de esta compensación."
                    },
                    {
                        "name": "order_id",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        },
                        "description": "Solo líneas que cancelaron la deuda de este pedido."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "procurement:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/SettlementOffsetLine"
                                            },
                                            "description": "Registros de la página."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID del registro borrado."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Cuándo se borró el registro."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Registros borrados de la base desde el cursor, como marcas de eliminación: solo con include_deleted=true en la continuación por el cursor de sincronización."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Cursor de la página siguiente; null en la última."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true si hay una página siguiente."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "En la última página — el cursor desde el que continuar más tarde: con él llega solo lo que cambió después de esta página. null en las demás."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            }
        },
        "/settlement-offset-lines/{settlement_offset_line}": {
            "get": {
                "operationId": "settlement_offset_lines.get",
                "summary": "Línea de compensación",
                "tags": [
                    "SettlementOffsetLines"
                ],
                "parameters": [
                    {
                        "name": "settlement_offset_line",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID de la línea de compensación."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "procurement:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/SettlementOffsetLine"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            }
        },
        "/settlement-offsets": {
            "get": {
                "operationId": "settlement_offsets.list",
                "summary": "Compensaciones: deudas recíprocas de un cliente y un proveedor canceladas con un documento de compensación",
                "tags": [
                    "SettlementOffsets"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Tamaño de página: hasta 250 registros; 50 por defecto."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Cursor opaco: next_cursor de la página anterior, o sync_cursor de la última página guardado por la sincronización anterior. El listado va en orden de confirmación, así que el cursor de sincronización devuelve luego solo lo que cambió después de él."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Solo los registros cambiados después de este momento, ISO 8601 con zona horaria. Un filtro de la primera sincronización; después se sigue con el cursor."
                    },
                    {
                        "name": "supplier_id",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        },
                        "description": "Solo documentos de este proveedor."
                    },
                    {
                        "name": "agreement_id",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        },
                        "description": "Solo compensaciones de este acuerdo."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "procurement:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/SettlementOffset"
                                            },
                                            "description": "Registros de la página."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID del registro borrado."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Cuándo se borró el registro."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Registros borrados de la base desde el cursor, como marcas de eliminación: solo con include_deleted=true en la continuación por el cursor de sincronización."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Cursor de la página siguiente; null en la última."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true si hay una página siguiente."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "En la última página — el cursor desde el que continuar más tarde: con él llega solo lo que cambió después de esta página. null en las demás."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            }
        },
        "/settlement-offsets/{settlement_offset}": {
            "get": {
                "operationId": "settlement_offsets.get",
                "summary": "Compensación",
                "tags": [
                    "SettlementOffsets"
                ],
                "parameters": [
                    {
                        "name": "settlement_offset",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID de la compensación."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "procurement:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/SettlementOffset"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            }
        },
        "/stock-movements": {
            "get": {
                "operationId": "stock_movements.list",
                "summary": "Diario de movimientos de stock: cada cambio del stock físico de un local",
                "tags": [
                    "StockMovements"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Tamaño de página: hasta 250 registros; 50 por defecto."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Cursor opaco: next_cursor de la página anterior, o sync_cursor de la última página guardado por la sincronización anterior. El listado va en orden de confirmación, así que el cursor de sincronización devuelve luego solo lo que cambió después de él."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Solo los registros cambiados después de este momento, ISO 8601 con zona horaria. Un filtro de la primera sincronización; después se sigue con el cursor."
                    },
                    {
                        "name": "variant_id",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        },
                        "description": "Solo movimientos de esta variante."
                    },
                    {
                        "name": "location_id",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        },
                        "description": "Solo movimientos de este local."
                    },
                    {
                        "name": "lot_id",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        },
                        "description": "Solo movimientos de este lote."
                    },
                    {
                        "name": "document_type",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "enum": [
                                "goods_receipt",
                                "stocktake",
                                "stock_write_off",
                                "production_order",
                                "location_transfer",
                                "group_transfer",
                                "supplier_return",
                                "order"
                            ]
                        },
                        "description": "Tipo de documento primario, junto con document_id: solo los movimientos cuyo documento primario es ese."
                    },
                    {
                        "name": "document_id",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        },
                        "description": "ID del documento primario, junto con document_type."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "inventory:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/StockMovement"
                                            },
                                            "description": "Registros de la página."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID del registro borrado."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Cuándo se borró el registro."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Registros borrados de la base desde el cursor, como marcas de eliminación: solo con include_deleted=true en la continuación por el cursor de sincronización."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Cursor de la página siguiente; null en la última."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true si hay una página siguiente."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "En la última página — el cursor desde el que continuar más tarde: con él llega solo lo que cambió después de esta página. null en las demás."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            }
        },
        "/stock-movements/{stock_movement}": {
            "get": {
                "operationId": "stock_movements.get",
                "summary": "Movimiento de stock",
                "tags": [
                    "StockMovements"
                ],
                "parameters": [
                    {
                        "name": "stock_movement",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID del movimiento de stock."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "inventory:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/StockMovement"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            }
        },
        "/stocktake-lines": {
            "get": {
                "operationId": "stocktake_lines.list",
                "summary": "Líneas de inventario: stock esperado, contado, diferencia y ajuste, modificadas desde un momento dado",
                "tags": [
                    "StocktakeLines"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Tamaño de página: hasta 250 registros; 50 por defecto."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Cursor opaco: next_cursor de la página anterior, o sync_cursor de la última página guardado por la sincronización anterior. El listado va en orden de confirmación, así que el cursor de sincronización devuelve luego solo lo que cambió después de él."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Solo los registros cambiados después de este momento, ISO 8601 con zona horaria. Un filtro de la primera sincronización; después se sigue con el cursor."
                    },
                    {
                        "name": "include_deleted",
                        "in": "query",
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "true — devolver también los registros eliminados: los archivados con deleted_at y los borrados de la base como marcas de eliminación {id, deleted_at} en la continuación por el cursor de sincronización. Activalo para sincronizar."
                    },
                    {
                        "name": "stocktake_id",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        },
                        "description": "Solo líneas de este inventario."
                    },
                    {
                        "name": "variant_id",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        },
                        "description": "Solo líneas de esta variante."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "inventory:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/StocktakeLine"
                                            },
                                            "description": "Registros de la página."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID del registro borrado."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Cuándo se borró el registro."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Registros borrados de la base desde el cursor, como marcas de eliminación: solo con include_deleted=true en la continuación por el cursor de sincronización."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Cursor de la página siguiente; null en la última."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true si hay una página siguiente."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "En la última página — el cursor desde el que continuar más tarde: con él llega solo lo que cambió después de esta página. null en las demás."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            }
        },
        "/stocktake-lines/{stocktake_line}": {
            "get": {
                "operationId": "stocktake_lines.get",
                "summary": "Línea de inventario",
                "tags": [
                    "StocktakeLines"
                ],
                "parameters": [
                    {
                        "name": "stocktake_line",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID de la línea de inventario."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "inventory:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/StocktakeLine"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            }
        },
        "/stocktakes": {
            "get": {
                "operationId": "stocktakes.list",
                "summary": "Inventarios: alcance, estado y fechas, modificados desde un momento dado",
                "tags": [
                    "Stocktakes"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Tamaño de página: hasta 250 registros; 50 por defecto."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Cursor opaco: next_cursor de la página anterior, o sync_cursor de la última página guardado por la sincronización anterior. El listado va en orden de confirmación, así que el cursor de sincronización devuelve luego solo lo que cambió después de él."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Solo los registros cambiados después de este momento, ISO 8601 con zona horaria. Un filtro de la primera sincronización; después se sigue con el cursor."
                    },
                    {
                        "name": "location_id",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        },
                        "description": "Solo inventarios de este local."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "inventory:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/Stocktake"
                                            },
                                            "description": "Registros de la página."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID del registro borrado."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Cuándo se borró el registro."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Registros borrados de la base desde el cursor, como marcas de eliminación: solo con include_deleted=true en la continuación por el cursor de sincronización."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Cursor de la página siguiente; null en la última."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true si hay una página siguiente."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "En la última página — el cursor desde el que continuar más tarde: con él llega solo lo que cambió después de esta página. null en las demás."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            }
        },
        "/stocktakes/{stocktake}": {
            "get": {
                "operationId": "stocktakes.get",
                "summary": "Inventario",
                "tags": [
                    "Stocktakes"
                ],
                "parameters": [
                    {
                        "name": "stocktake",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID del inventario."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "inventory:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Stocktake"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            }
        },
        "/store": {
            "get": {
                "operationId": "store.get",
                "summary": "Obtener la tienda: moneda, zona horaria e idiomas",
                "tags": [
                    "Store"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Store"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            }
        },
        "/supplier-bill-payments": {
            "get": {
                "operationId": "supplier_bill_payments.list",
                "summary": "Pagos de comprobantes de proveedores: con dinero, compensación, nota de crédito, anticipo, gasto del libro o fuera del sistema",
                "tags": [
                    "SupplierBillPayments"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Tamaño de página: hasta 250 registros; 50 por defecto."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Cursor opaco: next_cursor de la página anterior, o sync_cursor de la última página guardado por la sincronización anterior. El listado va en orden de confirmación, así que el cursor de sincronización devuelve luego solo lo que cambió después de él."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Solo los registros cambiados después de este momento, ISO 8601 con zona horaria. Un filtro de la primera sincronización; después se sigue con el cursor."
                    },
                    {
                        "name": "include_deleted",
                        "in": "query",
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "true — devolver también los registros eliminados: los archivados con deleted_at y los borrados de la base como marcas de eliminación {id, deleted_at} en la continuación por el cursor de sincronización. Activalo para sincronizar."
                    },
                    {
                        "name": "supplier_bill_id",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        },
                        "description": "Solo pagos de este comprobante de proveedor."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "procurement:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/SupplierBillPayment"
                                            },
                                            "description": "Registros de la página."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID del registro borrado."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Cuándo se borró el registro."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Registros borrados de la base desde el cursor, como marcas de eliminación: solo con include_deleted=true en la continuación por el cursor de sincronización."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Cursor de la página siguiente; null en la última."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true si hay una página siguiente."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "En la última página — el cursor desde el que continuar más tarde: con él llega solo lo que cambió después de esta página. null en las demás."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            }
        },
        "/supplier-bill-payments/{supplier_bill_payment}": {
            "get": {
                "operationId": "supplier_bill_payments.get",
                "summary": "Pago de comprobante de proveedor",
                "tags": [
                    "SupplierBillPayments"
                ],
                "parameters": [
                    {
                        "name": "supplier_bill_payment",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID del pago de comprobante de proveedor."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "procurement:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/SupplierBillPayment"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            }
        },
        "/supplier-bills/{supplier_bill}/payments/out-of-band": {
            "post": {
                "operationId": "supplier_bills.record_out_of_band_payment",
                "summary": "Marcar un comprobante de proveedor como pagado fuera del sistema",
                "tags": [
                    "SupplierBillPayments"
                ],
                "parameters": [
                    {
                        "name": "supplier_bill",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID del comprobante de proveedor."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatch"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/RecordOutOfBandSupplierBillPaymentRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "procurement:pay"
                        ]
                    }
                ],
                "responses": {
                    "201": {
                        "description": "Creado",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/SupplierBillPayment"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "supplier_bill_refused",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            }
        },
        "/supplier-bills/{supplier_bill}/payments/{supplier_bill_payment}": {
            "delete": {
                "operationId": "supplier_bills.delete_payment",
                "summary": "Anular un pago de comprobante de proveedor",
                "tags": [
                    "SupplierBillPayments"
                ],
                "parameters": [
                    {
                        "name": "supplier_bill",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID del comprobante de proveedor."
                    },
                    {
                        "name": "supplier_bill_payment",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID del pago de comprobante de proveedor."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatch"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "procurement:pay"
                        ]
                    }
                ],
                "responses": {
                    "204": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "in_use_conflict",
                    "supplier_bill_payment_locked",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            }
        },
        "/supplier-bills": {
            "get": {
                "operationId": "supplier_bills.list",
                "summary": "Comprobantes de proveedores: facturas, notas y deudas por entregas sin factura, con impuestos y líneas",
                "tags": [
                    "SupplierBills"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Tamaño de página: hasta 250 registros; 50 por defecto."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Cursor opaco: next_cursor de la página anterior, o sync_cursor de la última página guardado por la sincronización anterior. El listado va en orden de confirmación, así que el cursor de sincronización devuelve luego solo lo que cambió después de él."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Solo los registros cambiados después de este momento, ISO 8601 con zona horaria. Un filtro de la primera sincronización; después se sigue con el cursor."
                    },
                    {
                        "name": "include_deleted",
                        "in": "query",
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "true — devolver también los registros eliminados: los archivados con deleted_at y los borrados de la base como marcas de eliminación {id, deleted_at} en la continuación por el cursor de sincronización. Activalo para sincronizar."
                    },
                    {
                        "name": "supplier_id",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        },
                        "description": "Solo documentos de este proveedor."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "procurement:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/SupplierBill"
                                            },
                                            "description": "Registros de la página."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID del registro borrado."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Cuándo se borró el registro."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Registros borrados de la base desde el cursor, como marcas de eliminación: solo con include_deleted=true en la continuación por el cursor de sincronización."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Cursor de la página siguiente; null en la última."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true si hay una página siguiente."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "En la última página — el cursor desde el que continuar más tarde: con él llega solo lo que cambió después de esta página. null en las demás."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            },
            "post": {
                "operationId": "supplier_bills.create",
                "summary": "Crear un borrador de comprobante de proveedor",
                "tags": [
                    "SupplierBills"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/CreateSupplierBillRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "procurement:write"
                        ]
                    }
                ],
                "responses": {
                    "201": {
                        "description": "Creado",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            },
                            "Location": {
                                "$ref": "#/components/headers/Location"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/SupplierBill"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "idempotency_key_reused",
                    "invalid_idempotency_key"
                ]
            }
        },
        "/supplier-bills/{supplier_bill}": {
            "get": {
                "operationId": "supplier_bills.get",
                "summary": "Comprobante de proveedor",
                "tags": [
                    "SupplierBills"
                ],
                "parameters": [
                    {
                        "name": "supplier_bill",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID del comprobante de proveedor."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "procurement:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/SupplierBill"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            },
            "patch": {
                "operationId": "supplier_bills.update",
                "summary": "Cambiar un borrador de comprobante de proveedor",
                "tags": [
                    "SupplierBills"
                ],
                "parameters": [
                    {
                        "name": "supplier_bill",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID del comprobante de proveedor."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatch"
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/UpdateSupplierBillRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "procurement:write"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/SupplierBill"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "supplier_bill_refused",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            },
            "delete": {
                "operationId": "supplier_bills.delete",
                "summary": "Eliminar un borrador de comprobante de proveedor",
                "tags": [
                    "SupplierBills"
                ],
                "parameters": [
                    {
                        "name": "supplier_bill",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID del comprobante de proveedor."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatch"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "procurement:write"
                        ]
                    }
                ],
                "responses": {
                    "204": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "in_use_conflict",
                    "supplier_bill_refused",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            }
        },
        "/supplier-bills/{supplier_bill}/post": {
            "post": {
                "operationId": "supplier_bills.post",
                "summary": "Registrar un comprobante de proveedor: entra en las cuentas a pagar y el libro de compras",
                "tags": [
                    "SupplierBills"
                ],
                "parameters": [
                    {
                        "name": "supplier_bill",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID del comprobante de proveedor."
                    },
                    {
                        "name": "consent",
                        "in": "query",
                        "description": "Consentimientos a las consecuencias del cambio, por tipo: consent[<consent_kind>]=<consent_token> de una respuesta 409 consent_required. Conservá los consentimientos ya dados cuando se pide el tipo siguiente.",
                        "style": "deepObject",
                        "explode": true,
                        "schema": {
                            "type": "object",
                            "properties": {
                                "vendor_tax_id": {
                                    "type": "string",
                                    "minLength": 64,
                                    "maxLength": 64,
                                    "description": "El proveedor mandó el comprobante sin CUIT en su ficha: el registro guarda en la ficha el CUIT de la factura. suppliers indica cuántas fichas cambian."
                                },
                                "close_returns": {
                                    "type": "string",
                                    "minLength": 64,
                                    "maxLength": 64,
                                    "description": "La nota de crédito cubre por completo devoluciones al proveedor: el registro las cierra. supplier_returns indica cuántas devoluciones se cierran."
                                }
                            },
                            "additionalProperties": false
                        }
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatch"
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/PostSupplierBillCommandRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "procurement:write"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/SupplierBill"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "consent_required",
                    "idempotency_key_in_use",
                    "supplier_bill_refused",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            }
        },
        "/supplier-bills/{supplier_bill}/void": {
            "post": {
                "operationId": "supplier_bills.void",
                "summary": "Anular un comprobante de proveedor junto con sus pagos y compensaciones",
                "tags": [
                    "SupplierBills"
                ],
                "parameters": [
                    {
                        "name": "supplier_bill",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID del comprobante de proveedor."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatch"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "procurement:write"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/SupplierBill"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "supplier_bill_refused",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            }
        },
        "/supplier-bills/{supplier_bill}/approve": {
            "post": {
                "operationId": "supplier_bills.approve",
                "summary": "Aprobar el pago de un comprobante de proveedor registrado",
                "tags": [
                    "SupplierBills"
                ],
                "parameters": [
                    {
                        "name": "supplier_bill",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID del comprobante de proveedor."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatch"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "procurement:approve"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/SupplierBill"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "supplier_bill_refused",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            }
        },
        "/supplier-bills/{supplier_bill}/revoke-approval": {
            "post": {
                "operationId": "supplier_bills.revoke_approval",
                "summary": "Revocar la aprobación de pago de un comprobante de proveedor",
                "tags": [
                    "SupplierBills"
                ],
                "parameters": [
                    {
                        "name": "supplier_bill",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID del comprobante de proveedor."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatch"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "procurement:approve"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/SupplierBill"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "supplier_bill_refused",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            }
        },
        "/supplier-returns": {
            "get": {
                "operationId": "supplier_returns.list",
                "summary": "Devoluciones a proveedores: mercadería enviada de vuelta y su compensación",
                "tags": [
                    "SupplierReturns"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Tamaño de página: hasta 250 registros; 50 por defecto."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Cursor opaco: next_cursor de la página anterior, o sync_cursor de la última página guardado por la sincronización anterior. El listado va en orden de confirmación, así que el cursor de sincronización devuelve luego solo lo que cambió después de él."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Solo los registros cambiados después de este momento, ISO 8601 con zona horaria. Un filtro de la primera sincronización; después se sigue con el cursor."
                    },
                    {
                        "name": "include_deleted",
                        "in": "query",
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "true — devolver también los registros eliminados: los archivados con deleted_at y los borrados de la base como marcas de eliminación {id, deleted_at} en la continuación por el cursor de sincronización. Activalo para sincronizar."
                    },
                    {
                        "name": "supplier_id",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        },
                        "description": "Solo documentos de este proveedor."
                    },
                    {
                        "name": "goods_receipt_id",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        },
                        "description": "Solo devoluciones de esta recepción."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "procurement:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/SupplierReturn"
                                            },
                                            "description": "Registros de la página."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID del registro borrado."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Cuándo se borró el registro."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Registros borrados de la base desde el cursor, como marcas de eliminación: solo con include_deleted=true en la continuación por el cursor de sincronización."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Cursor de la página siguiente; null en la última."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true si hay una página siguiente."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "En la última página — el cursor desde el que continuar más tarde: con él llega solo lo que cambió después de esta página. null en las demás."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            }
        },
        "/supplier-returns/{supplier_return}": {
            "get": {
                "operationId": "supplier_returns.get",
                "summary": "Devolución a proveedor",
                "tags": [
                    "SupplierReturns"
                ],
                "parameters": [
                    {
                        "name": "supplier_return",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID de la devolución a proveedor."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "procurement:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/SupplierReturn"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            }
        },
        "/suppliers": {
            "get": {
                "operationId": "suppliers.list",
                "summary": "Proveedores de la tienda: datos fiscales y condiciones de pago",
                "tags": [
                    "Suppliers"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Tamaño de página: hasta 250 registros; 50 por defecto."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Cursor opaco: next_cursor de la página anterior, o sync_cursor de la última página guardado por la sincronización anterior. El listado va en orden de confirmación, así que el cursor de sincronización devuelve luego solo lo que cambió después de él."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Solo los registros cambiados después de este momento, ISO 8601 con zona horaria. Un filtro de la primera sincronización; después se sigue con el cursor."
                    },
                    {
                        "name": "include_deleted",
                        "in": "query",
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "true — devolver también los registros eliminados: los archivados con deleted_at y los borrados de la base como marcas de eliminación {id, deleted_at} en la continuación por el cursor de sincronización. Activalo para sincronizar."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "procurement:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/Supplier"
                                            },
                                            "description": "Registros de la página."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID del registro borrado."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Cuándo se borró el registro."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Registros borrados de la base desde el cursor, como marcas de eliminación: solo con include_deleted=true en la continuación por el cursor de sincronización."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Cursor de la página siguiente; null en la última."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true si hay una página siguiente."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "En la última página — el cursor desde el que continuar más tarde: con él llega solo lo que cambió después de esta página. null en las demás."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            },
            "post": {
                "operationId": "suppliers.create",
                "summary": "Crear un proveedor: datos fiscales y condiciones de pago",
                "tags": [
                    "Suppliers"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/CreateSupplierRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "procurement:write"
                        ]
                    }
                ],
                "responses": {
                    "201": {
                        "description": "Creado",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            },
                            "Location": {
                                "$ref": "#/components/headers/Location"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Supplier"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "external_id_in_use",
                    "idempotency_key_in_use",
                    "record_limit_reached",
                    "idempotency_key_reused",
                    "invalid_idempotency_key"
                ]
            }
        },
        "/suppliers/{supplier}": {
            "get": {
                "operationId": "suppliers.get",
                "summary": "Proveedor",
                "tags": [
                    "Suppliers"
                ],
                "parameters": [
                    {
                        "name": "supplier",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID del proveedor."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "procurement:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Supplier"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            },
            "patch": {
                "operationId": "suppliers.update",
                "summary": "Actualizar los datos fiscales, las condiciones de pago y el ID externo de un proveedor",
                "tags": [
                    "Suppliers"
                ],
                "parameters": [
                    {
                        "name": "supplier",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID del proveedor."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatch"
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/UpdateSupplierRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "procurement:write"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Supplier"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "external_id_in_use",
                    "idempotency_key_in_use",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            }
        },
        "/suppliers/by-external-id/{external_id}": {
            "get": {
                "operationId": "suppliers.get_by_external_id",
                "summary": "Proveedor por su ID externo",
                "tags": [
                    "Suppliers"
                ],
                "parameters": [
                    {
                        "name": "external_id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "ID externo: el ID del registro en tu sistema."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "procurement:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Supplier"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            },
            "patch": {
                "operationId": "suppliers.upsert",
                "summary": "Crear o actualizar un proveedor por su ID externo",
                "tags": [
                    "Suppliers"
                ],
                "parameters": [
                    {
                        "name": "external_id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "ID externo: el ID del registro en tu sistema."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatchUpsert"
                    },
                    {
                        "$ref": "#/components/parameters/IfNoneMatch"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "procurement:write"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Supplier"
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Creado",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            },
                            "Location": {
                                "$ref": "#/components/headers/Location"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Supplier"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "record_limit_reached",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            }
        },
        "/suppliers/{supplier}/balance": {
            "get": {
                "operationId": "suppliers.get_balance",
                "summary": "Saldo del proveedor: cuánto le debe la tienda ahora, por componente y vencimiento",
                "tags": [
                    "Suppliers"
                ],
                "parameters": [
                    {
                        "name": "supplier",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID del proveedor."
                    },
                    {
                        "name": "legal_entity_id",
                        "in": "query",
                        "schema": {
                            "type": "integer"
                        },
                        "description": "Solo la deuda con esta razón social de la tienda."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "procurement:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/SupplierBalance"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            }
        },
        "/suppliers/{supplier}/statement": {
            "get": {
                "operationId": "suppliers.get_statement",
                "summary": "Conciliación de saldos con el proveedor en un período: saldo inicial y final, líneas con saldo acumulado",
                "tags": [
                    "Suppliers"
                ],
                "parameters": [
                    {
                        "name": "supplier",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID del proveedor."
                    },
                    {
                        "name": "from",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date"
                        },
                        "description": "Primer día del período, AAAA-MM-DD en la zona horaria de la tienda; por defecto, el día de la primera línea de la conciliación."
                    },
                    {
                        "name": "to",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date"
                        },
                        "description": "Último día del período, AAAA-MM-DD en la zona horaria de la tienda; por defecto, hoy."
                    },
                    {
                        "name": "legal_entity_id",
                        "in": "query",
                        "schema": {
                            "type": "integer"
                        },
                        "description": "Conciliación de esta razón social de la tienda: solo su parte de líneas y saldos."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "procurement:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/SupplierStatement"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            }
        },
        "/tax-classes": {
            "get": {
                "operationId": "tax_classes.list",
                "summary": "Listar las clases de impuesto de la tienda: el tipo y la alícuota de impuesto con que se vende un producto",
                "tags": [
                    "TaxClasses"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Tamaño de página: hasta 250 registros; 50 por defecto."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Cursor opaco: next_cursor de la página anterior, o sync_cursor de la última página guardado por la sincronización anterior. El listado va en orden de confirmación, así que el cursor de sincronización devuelve luego solo lo que cambió después de él."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Solo los registros cambiados después de este momento, ISO 8601 con zona horaria. Un filtro de la primera sincronización; después se sigue con el cursor."
                    },
                    {
                        "name": "include_deleted",
                        "in": "query",
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "true — devolver también los registros eliminados: los archivados con deleted_at y los borrados de la base como marcas de eliminación {id, deleted_at} en la continuación por el cursor de sincronización. Activalo para sincronizar."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "catalog:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/TaxClass"
                                            },
                                            "description": "Registros de la página."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID del registro borrado."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Cuándo se borró el registro."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Registros borrados de la base desde el cursor, como marcas de eliminación: solo con include_deleted=true en la continuación por el cursor de sincronización."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Cursor de la página siguiente; null en la última."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true si hay una página siguiente."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "En la última página — el cursor desde el que continuar más tarde: con él llega solo lo que cambió después de esta página. null en las demás."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            }
        },
        "/tax-periods": {
            "get": {
                "operationId": "tax_periods.list",
                "summary": "Listar los períodos fiscales de las razones sociales: qué meses están cerrados y son definitivos",
                "tags": [
                    "TaxPeriods"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Tamaño de página: hasta 250 registros; 50 por defecto."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Cursor opaco: next_cursor de la página anterior, o sync_cursor de la última página guardado por la sincronización anterior. El listado va en orden de confirmación, así que el cursor de sincronización devuelve luego solo lo que cambió después de él."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Solo los registros cambiados después de este momento, ISO 8601 con zona horaria. Un filtro de la primera sincronización; después se sigue con el cursor."
                    },
                    {
                        "name": "include_deleted",
                        "in": "query",
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "true — devolver también los registros eliminados: los archivados con deleted_at y los borrados de la base como marcas de eliminación {id, deleted_at} en la continuación por el cursor de sincronización. Activalo para sincronizar."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "fiscal:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/TaxPeriod"
                                            },
                                            "description": "Registros de la página."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID del registro borrado."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Cuándo se borró el registro."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Registros borrados de la base desde el cursor, como marcas de eliminación: solo con include_deleted=true en la continuación por el cursor de sincronización."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Cursor de la página siguiente; null en la última."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true si hay una página siguiente."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "En la última página — el cursor desde el que continuar más tarde: con él llega solo lo que cambió después de esta página. null en las demás."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "capability_disabled",
                    "cursor_expired"
                ]
            }
        },
        "/tax-withholdings": {
            "get": {
                "operationId": "tax_withholdings.list",
                "summary": "Listar las retenciones y percepciones cambiadas desde un momento: lo que le retuvieron a la tienda, a computar, y lo que retuvo la tienda, a ingresar",
                "tags": [
                    "TaxWithholdings"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Tamaño de página: hasta 250 registros; 50 por defecto."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Cursor opaco: next_cursor de la página anterior, o sync_cursor de la última página guardado por la sincronización anterior. El listado va en orden de confirmación, así que el cursor de sincronización devuelve luego solo lo que cambió después de él."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Solo los registros cambiados después de este momento, ISO 8601 con zona horaria. Un filtro de la primera sincronización; después se sigue con el cursor."
                    },
                    {
                        "name": "include_deleted",
                        "in": "query",
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "true — devolver también los registros eliminados: los archivados con deleted_at y los borrados de la base como marcas de eliminación {id, deleted_at} en la continuación por el cursor de sincronización. Activalo para sincronizar."
                    },
                    {
                        "name": "direction",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "enum": [
                                "suffered",
                                "practiced"
                            ]
                        },
                        "description": "Solo un lado del registro: suffered — lo que le retuvieron a la tienda, practiced — lo que retuvo la tienda."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "fiscal:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/TaxWithholding"
                                            },
                                            "description": "Registros de la página."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID del registro borrado."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Cuándo se borró el registro."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Registros borrados de la base desde el cursor, como marcas de eliminación: solo con include_deleted=true en la continuación por el cursor de sincronización."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Cursor de la página siguiente; null en la última."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true si hay una página siguiente."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "En la última página — el cursor desde el que continuar más tarde: con él llega solo lo que cambió después de esta página. null en las demás."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            }
        },
        "/tax-withholdings/{tax_withholding}": {
            "get": {
                "operationId": "tax_withholdings.get",
                "summary": "Obtener una retención o percepción",
                "tags": [
                    "TaxWithholdings"
                ],
                "parameters": [
                    {
                        "name": "tax_withholding",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID de la retención o percepción."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "fiscal:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/TaxWithholding"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            }
        },
        "/tax-withholdings/{tax_withholding}/certificate": {
            "get": {
                "operationId": "tax_withholdings.get_certificate",
                "summary": "Descargar el PDF del certificado de retención que la tienda le entrega a la contraparte",
                "tags": [
                    "TaxWithholdings"
                ],
                "parameters": [
                    {
                        "name": "tax_withholding",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID de la retención o percepción."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "fiscal:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/pdf": {
                                "schema": {
                                    "type": "string",
                                    "format": "binary"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "tax_withholding_certificate_unavailable"
                ]
            }
        },
        "/uploads/{upload}": {
            "get": {
                "operationId": "uploads.get",
                "summary": "Obtener una carga de archivo por partes: cuánto se recibió",
                "tags": [
                    "Uploads"
                ],
                "parameters": [
                    {
                        "name": "upload",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID de la carga."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "bulk:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Upload"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            }
        },
        "/uploads": {
            "post": {
                "operationId": "uploads.create",
                "summary": "Iniciar una carga de archivo por partes: la entrada de una operación masiva",
                "tags": [
                    "Uploads"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/CreateUploadRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "bulk:write"
                        ]
                    }
                ],
                "responses": {
                    "201": {
                        "description": "Creado",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Upload"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "idempotency_key_reused",
                    "invalid_idempotency_key"
                ]
            }
        },
        "/uploads/{upload}/chunks": {
            "post": {
                "operationId": "upload_chunks.create",
                "summary": "Agregar una parte del archivo como cuerpo crudo",
                "tags": [
                    "Uploads"
                ],
                "parameters": [
                    {
                        "name": "upload",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "ID de la carga."
                    },
                    {
                        "name": "offset",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "integer",
                            "minimum": 0
                        },
                        "description": "Byte del archivo donde empieza la parte: igual a received de la carga, si no, 409 upload_offset_mismatch. La parte en sí es el cuerpo crudo de la solicitud."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/octet-stream": {
                            "schema": {
                                "type": "string",
                                "format": "binary"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "bulk:write"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Upload"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "upload_offset_mismatch",
                    "idempotency_key_reused",
                    "invalid_idempotency_key"
                ]
            }
        },
        "/variants": {
            "get": {
                "operationId": "variants.list",
                "summary": "Listar las variantes: SKU, códigos de barras, precios y unidades",
                "tags": [
                    "Variants"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Tamaño de página: hasta 250 registros; 50 por defecto."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Cursor opaco: next_cursor de la página anterior, o sync_cursor de la última página guardado por la sincronización anterior. El listado va en orden de confirmación, así que el cursor de sincronización devuelve luego solo lo que cambió después de él."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Solo los registros cambiados después de este momento, ISO 8601 con zona horaria. Un filtro de la primera sincronización; después se sigue con el cursor."
                    },
                    {
                        "name": "include_deleted",
                        "in": "query",
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "true — devolver también los registros eliminados: los archivados con deleted_at y los borrados de la base como marcas de eliminación {id, deleted_at} en la continuación por el cursor de sincronización. Activalo para sincronizar."
                    },
                    {
                        "name": "product_id",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        },
                        "description": "Solo los registros de este producto."
                    },
                    {
                        "name": "sku",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 64
                        },
                        "description": "Solo la variante con este SKU."
                    },
                    {
                        "name": "barcode",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 512
                        },
                        "description": "Solo las variantes con este código de barras."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "catalog:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/Variant"
                                            },
                                            "description": "Registros de la página."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID del registro borrado."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Cuándo se borró el registro."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Registros borrados de la base desde el cursor, como marcas de eliminación: solo con include_deleted=true en la continuación por el cursor de sincronización."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Cursor de la página siguiente; null en la última."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true si hay una página siguiente."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "En la última página — el cursor desde el que continuar más tarde: con él llega solo lo que cambió después de esta página. null en las demás."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            },
            "post": {
                "operationId": "variants.create",
                "summary": "Agregar una variante a un producto",
                "tags": [
                    "Variants"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/CreateVariantRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "catalog:write"
                        ]
                    }
                ],
                "responses": {
                    "201": {
                        "description": "Creado",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            },
                            "Location": {
                                "$ref": "#/components/headers/Location"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Variant"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "external_id_archived",
                    "external_id_in_use",
                    "idempotency_key_in_use",
                    "idempotency_key_reused",
                    "invalid_idempotency_key"
                ]
            }
        },
        "/variants/{variant}": {
            "get": {
                "operationId": "variants.get",
                "summary": "Obtener una variante",
                "tags": [
                    "Variants"
                ],
                "parameters": [
                    {
                        "name": "variant",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID de la variante."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "catalog:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Variant"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            },
            "patch": {
                "operationId": "variants.update",
                "summary": "Modificar una variante de producto",
                "tags": [
                    "Variants"
                ],
                "parameters": [
                    {
                        "name": "variant",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID de la variante."
                    },
                    {
                        "name": "consent",
                        "in": "query",
                        "description": "Consentimientos a las consecuencias del cambio, por tipo: consent[<consent_kind>]=<consent_token> de una respuesta 409 consent_required. Conservá los consentimientos ya dados cuando se pide el tipo siguiente.",
                        "style": "deepObject",
                        "explode": true,
                        "schema": {
                            "type": "object",
                            "properties": {
                                "measure_change": {
                                    "type": "string",
                                    "minLength": 64,
                                    "maxLength": 64,
                                    "description": "La variante cambia cómo se vende (por unidad o por medida): se convierten su stock, precios y límites."
                                },
                                "piece_mode_off": {
                                    "type": "string",
                                    "minLength": 64,
                                    "maxLength": 64,
                                    "description": "Los packs de la variante se archivan cuando deja de venderse en packs."
                                },
                                "stock_source": {
                                    "type": "string",
                                    "minLength": 64,
                                    "maxLength": 64,
                                    "description": "El stock propio de la variante pasa a su variante base, y desde ahora se vende del stock de la base."
                                },
                                "program_menu": {
                                    "type": "string",
                                    "minLength": 64,
                                    "maxLength": 64,
                                    "description": "El plato sale de los menús de los planes de comidas por suscripción."
                                }
                            },
                            "additionalProperties": false
                        }
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatch"
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/UpdateVariantRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "catalog:write"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Variant"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "consent_required",
                    "external_id_archived",
                    "external_id_in_use",
                    "idempotency_key_in_use",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            },
            "delete": {
                "operationId": "variants.delete",
                "summary": "Archivar una variante de producto",
                "tags": [
                    "Variants"
                ],
                "parameters": [
                    {
                        "name": "variant",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID de la variante."
                    },
                    {
                        "name": "consent",
                        "in": "query",
                        "description": "Consentimientos a las consecuencias del cambio, por tipo: consent[<consent_kind>]=<consent_token> de una respuesta 409 consent_required. Conservá los consentimientos ya dados cuando se pide el tipo siguiente.",
                        "style": "deepObject",
                        "explode": true,
                        "schema": {
                            "type": "object",
                            "properties": {
                                "recipe_ingredient": {
                                    "type": "string",
                                    "minLength": 64,
                                    "maxLength": 64,
                                    "description": "El producto es ingrediente de recetas vigentes y sale de ellas."
                                },
                                "production_draft": {
                                    "type": "string",
                                    "minLength": 64,
                                    "maxLength": 64,
                                    "description": "Se cancelan los borradores de actas de producción con el producto."
                                },
                                "program_menu": {
                                    "type": "string",
                                    "minLength": 64,
                                    "maxLength": 64,
                                    "description": "El plato sale de los menús de los planes de comidas por suscripción."
                                },
                                "stock_dependents": {
                                    "type": "string",
                                    "minLength": 64,
                                    "maxLength": 64,
                                    "description": "Los packs que se venden del stock de esta variante pasan a ser variantes comunes con stock cero."
                                }
                            },
                            "additionalProperties": false
                        }
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatch"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "catalog:write"
                        ]
                    }
                ],
                "responses": {
                    "204": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "consent_required",
                    "idempotency_key_in_use",
                    "in_use_conflict",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "last_variant_of_product",
                    "precondition_required"
                ]
            }
        },
        "/variants/by-external-id/{external_id}": {
            "get": {
                "operationId": "variants.get_by_external_id",
                "summary": "Obtener una variante por su ID externo",
                "tags": [
                    "Variants"
                ],
                "parameters": [
                    {
                        "name": "external_id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "ID externo: el ID del registro en tu sistema."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "catalog:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Variant"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            },
            "patch": {
                "operationId": "variants.upsert",
                "summary": "Crear o modificar una variante por su ID en la app",
                "tags": [
                    "Variants"
                ],
                "parameters": [
                    {
                        "name": "external_id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "ID externo: el ID del registro en tu sistema."
                    },
                    {
                        "name": "consent",
                        "in": "query",
                        "description": "Consentimientos a las consecuencias del cambio, por tipo: consent[<consent_kind>]=<consent_token> de una respuesta 409 consent_required. Conservá los consentimientos ya dados cuando se pide el tipo siguiente.",
                        "style": "deepObject",
                        "explode": true,
                        "schema": {
                            "type": "object",
                            "properties": {
                                "measure_change": {
                                    "type": "string",
                                    "minLength": 64,
                                    "maxLength": 64,
                                    "description": "La variante cambia cómo se vende (por unidad o por medida): se convierten su stock, precios y límites."
                                },
                                "piece_mode_off": {
                                    "type": "string",
                                    "minLength": 64,
                                    "maxLength": 64,
                                    "description": "Los packs de la variante se archivan cuando deja de venderse en packs."
                                },
                                "stock_source": {
                                    "type": "string",
                                    "minLength": 64,
                                    "maxLength": 64,
                                    "description": "El stock propio de la variante pasa a su variante base, y desde ahora se vende del stock de la base."
                                },
                                "program_menu": {
                                    "type": "string",
                                    "minLength": 64,
                                    "maxLength": 64,
                                    "description": "El plato sale de los menús de los planes de comidas por suscripción."
                                }
                            },
                            "additionalProperties": false
                        }
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatchUpsert"
                    },
                    {
                        "$ref": "#/components/parameters/IfNoneMatch"
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/UpsertVariantRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "catalog:write"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Variant"
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Creado",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            },
                            "Location": {
                                "$ref": "#/components/headers/Location"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Variant"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "consent_required",
                    "external_id_archived",
                    "idempotency_key_in_use",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            }
        },
        "/variants/{variant}/recipe": {
            "get": {
                "operationId": "variants.get_recipe",
                "summary": "Obtener la receta de una variante: componentes y rendimiento del preelaborado",
                "tags": [
                    "Variants"
                ],
                "parameters": [
                    {
                        "name": "variant",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID de la variante."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "catalog:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/VariantRecipe"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            },
            "put": {
                "operationId": "variants.replace_recipe",
                "summary": "Reemplazar la receta de una variante: componentes y rendimiento del preelaborado",
                "tags": [
                    "Variants"
                ],
                "parameters": [
                    {
                        "name": "variant",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID de la variante."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatch"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/ReplaceVariantRecipeRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "catalog:write"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/VariantRecipe"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            }
        },
        "/webhook-endpoints/{endpoint}/deliveries": {
            "get": {
                "operationId": "webhook_deliveries.list",
                "summary": "Entregas de un endpoint de webhook: lo enviado, lo que espera un reintento y lo que falló",
                "tags": [
                    "WebhookDeliveries"
                ],
                "parameters": [
                    {
                        "name": "endpoint",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID del endpoint del webhook."
                    },
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Tamaño de página: hasta 250 registros; 50 por defecto."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Cursor opaco: next_cursor de la página anterior, o sync_cursor de la última página guardado por la sincronización anterior. El listado va en orden de confirmación, así que el cursor de sincronización devuelve luego solo lo que cambió después de él."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Solo los registros cambiados después de este momento, ISO 8601 con zona horaria. Un filtro de la primera sincronización; después se sigue con el cursor."
                    },
                    {
                        "name": "status",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "enum": [
                                "pending",
                                "succeeded",
                                "failed"
                            ]
                        },
                        "description": "Solo las entregas en este estado."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "webhooks:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/WebhookDelivery"
                                            },
                                            "description": "Registros de la página."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID del registro borrado."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Cuándo se borró el registro."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Registros borrados de la base desde el cursor, como marcas de eliminación: solo con include_deleted=true en la continuación por el cursor de sincronización."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Cursor de la página siguiente; null en la última."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true si hay una página siguiente."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "En la última página — el cursor desde el que continuar más tarde: con él llega solo lo que cambió después de esta página. null en las demás."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            }
        },
        "/webhook-deliveries/{delivery}": {
            "get": {
                "operationId": "webhook_deliveries.get",
                "summary": "Una entrega de webhook con todos sus intentos y respuestas del receptor",
                "tags": [
                    "WebhookDeliveries"
                ],
                "parameters": [
                    {
                        "name": "delivery",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID de la entrega del webhook."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "webhooks:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/WebhookDelivery"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            }
        },
        "/webhook-endpoints/{endpoint}/test": {
            "post": {
                "operationId": "webhook_endpoints.test",
                "summary": "Enviar al endpoint el evento de prueba ping — un intento firmado con el secreto actual",
                "tags": [
                    "WebhookDeliveries"
                ],
                "parameters": [
                    {
                        "name": "endpoint",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID del endpoint del webhook."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "webhooks:write"
                        ]
                    }
                ],
                "responses": {
                    "202": {
                        "description": "Aceptado: el resultado está en la dirección de Location",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "Location": {
                                "$ref": "#/components/headers/Location"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/WebhookDelivery"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "idempotency_key_reused",
                    "invalid_idempotency_key"
                ]
            }
        },
        "/webhook-deliveries/{delivery}/retry": {
            "post": {
                "operationId": "webhook_deliveries.retry",
                "summary": "Reintentar la entrega ahora, con el mismo cuerpo y el mismo webhook-id",
                "tags": [
                    "WebhookDeliveries"
                ],
                "parameters": [
                    {
                        "name": "delivery",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID de la entrega del webhook."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "webhooks:write"
                        ]
                    }
                ],
                "responses": {
                    "202": {
                        "description": "Aceptado: el resultado está en la dirección de Location",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "Location": {
                                "$ref": "#/components/headers/Location"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/WebhookDelivery"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "idempotency_key_reused",
                    "invalid_idempotency_key"
                ]
            }
        },
        "/webhook-endpoints": {
            "get": {
                "operationId": "webhook_endpoints.list",
                "summary": "Listar los endpoints de webhook de la app",
                "tags": [
                    "WebhookEndpoints"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Tamaño de página: hasta 250 registros; 50 por defecto."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Cursor opaco: next_cursor de la página anterior, o sync_cursor de la última página guardado por la sincronización anterior. El listado va en orden de confirmación, así que el cursor de sincronización devuelve luego solo lo que cambió después de él."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Solo los registros cambiados después de este momento, ISO 8601 con zona horaria. Un filtro de la primera sincronización; después se sigue con el cursor."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "webhooks:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/WebhookEndpoint"
                                            },
                                            "description": "Registros de la página."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID del registro borrado."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Cuándo se borró el registro."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Registros borrados de la base desde el cursor, como marcas de eliminación: solo con include_deleted=true en la continuación por el cursor de sincronización."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Cursor de la página siguiente; null en la última."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true si hay una página siguiente."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "En la última página — el cursor desde el que continuar más tarde: con él llega solo lo que cambió después de esta página. null en las demás."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            },
            "post": {
                "operationId": "webhook_endpoints.create",
                "summary": "Agregar un endpoint de webhook y suscribirlo a tipos de evento",
                "tags": [
                    "WebhookEndpoints"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/CreateWebhookEndpointRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "webhooks:write"
                        ]
                    }
                ],
                "responses": {
                    "201": {
                        "description": "Creado",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            },
                            "Location": {
                                "$ref": "#/components/headers/Location"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/WebhookEndpoint"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "webhook_endpoint_limit_reached",
                    "idempotency_key_reused",
                    "invalid_idempotency_key"
                ]
            }
        },
        "/webhook-endpoints/{endpoint}": {
            "get": {
                "operationId": "webhook_endpoints.get",
                "summary": "Obtener un endpoint de webhook",
                "tags": [
                    "WebhookEndpoints"
                ],
                "parameters": [
                    {
                        "name": "endpoint",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID del endpoint del webhook."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "webhooks:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/WebhookEndpoint"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            },
            "patch": {
                "operationId": "webhook_endpoints.update",
                "summary": "Modificar un endpoint de webhook: URL, descripción, tipos de evento, estado",
                "tags": [
                    "WebhookEndpoints"
                ],
                "parameters": [
                    {
                        "name": "endpoint",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID del endpoint del webhook."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatch"
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/UpdateWebhookEndpointRequest"
                            }
                        }
                    }
                },
                "security": [
                    {
                        "apiToken": [
                            "webhooks:write"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/WebhookEndpoint"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            },
            "delete": {
                "operationId": "webhook_endpoints.delete",
                "summary": "Eliminar un endpoint de webhook",
                "tags": [
                    "WebhookEndpoints"
                ],
                "parameters": [
                    {
                        "name": "endpoint",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID del endpoint del webhook."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    },
                    {
                        "$ref": "#/components/parameters/IfMatch"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "webhooks:write"
                        ]
                    }
                ],
                "responses": {
                    "204": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "412": {
                        "$ref": "#/components/responses/PreconditionFailed"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "428": {
                        "$ref": "#/components/responses/PreconditionRequired"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "in_use_conflict",
                    "precondition_failed",
                    "idempotency_key_reused",
                    "invalid_idempotency_key",
                    "precondition_required"
                ]
            }
        },
        "/webhook-endpoints/{endpoint}/rotate-secret": {
            "post": {
                "operationId": "webhook_endpoints.rotate_secret",
                "summary": "Emitir un nuevo secreto de firma: el anterior sigue firmando las entregas junto con él durante 24 horas",
                "tags": [
                    "WebhookEndpoints"
                ],
                "parameters": [
                    {
                        "name": "endpoint",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID del endpoint del webhook."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "webhooks:write"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            },
                            "Idempotent-Replayed": {
                                "$ref": "#/components/headers/IdempotentReplayed"
                            },
                            "ETag": {
                                "$ref": "#/components/headers/ETag"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/WebhookEndpoint"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "409": {
                        "$ref": "#/components/responses/Conflict"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "idempotency_key_in_use",
                    "idempotency_key_reused",
                    "invalid_idempotency_key"
                ]
            }
        },
        "/webhook-endpoints/{endpoint}/secret": {
            "get": {
                "operationId": "webhook_endpoints.get_secret",
                "summary": "Obtener el secreto de firma de las entregas de un endpoint de webhook",
                "tags": [
                    "WebhookEndpoints"
                ],
                "parameters": [
                    {
                        "name": "endpoint",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "ID del endpoint del webhook."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "webhooks:write"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/WebhookEndpointSecret"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": []
            }
        },
        "/write-off-reasons": {
            "get": {
                "operationId": "write_off_reasons.list",
                "summary": "Listar los motivos de baja de la tienda",
                "tags": [
                    "WriteOffReasons"
                ],
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 250
                        },
                        "description": "Tamaño de página: hasta 250 registros; 50 por defecto."
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "maxLength": 4096
                        },
                        "description": "Cursor opaco: next_cursor de la página anterior, o sync_cursor de la última página guardado por la sincronización anterior. El listado va en orden de confirmación, así que el cursor de sincronización devuelve luego solo lo que cambió después de él."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$"
                        },
                        "description": "Solo los registros cambiados después de este momento, ISO 8601 con zona horaria. Un filtro de la primera sincronización; después se sigue con el cursor."
                    },
                    {
                        "name": "include_deleted",
                        "in": "query",
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "true — devolver también los registros eliminados: los archivados con deleted_at y los borrados de la base como marcas de eliminación {id, deleted_at} en la continuación por el cursor de sincronización. Activalo para sincronizar."
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    }
                ],
                "security": [
                    {
                        "apiToken": [
                            "inventory:read"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Éxito",
                        "headers": {
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "X-Request-Id": {
                                "$ref": "#/components/headers/RequestId"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/WriteOffReason"
                                            },
                                            "description": "Registros de la página."
                                        },
                                        "deleted": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer",
                                                        "description": "ID del registro borrado."
                                                    },
                                                    "deleted_at": {
                                                        "type": "string",
                                                        "format": "date-time",
                                                        "description": "Cuándo se borró el registro."
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "deleted_at"
                                                ]
                                            },
                                            "description": "Registros borrados de la base desde el cursor, como marcas de eliminación: solo con include_deleted=true en la continuación por el cursor de sincronización."
                                        },
                                        "next_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Cursor de la página siguiente; null en la última."
                                        },
                                        "has_more": {
                                            "type": "boolean",
                                            "description": "true si hay una página siguiente."
                                        },
                                        "sync_cursor": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "En la última página — el cursor desde el que continuar más tarde: con él llega solo lo que cambió después de esta página. null en las demás."
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "deleted",
                                        "next_cursor",
                                        "has_more",
                                        "sync_cursor"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "403": {
                        "$ref": "#/components/responses/Forbidden"
                    },
                    "410": {
                        "$ref": "#/components/responses/CursorExpired"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationFailed"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooManyRequests"
                    },
                    "503": {
                        "$ref": "#/components/responses/ServiceUnavailable"
                    }
                },
                "x-problem-types": [
                    "cursor_expired"
                ]
            }
        }
    },
    "components": {
        "schemas": {
            "AdjustInventoryLevelRequest": {
                "type": "object",
                "properties": {
                    "variant_id": {
                        "type": "integer",
                        "description": "ID de la variante. Junto con location_id identifica el nivel de stock; un par que no está en la lista tiene stock cero."
                    },
                    "location_id": {
                        "type": "integer",
                        "description": "ID del local de la tienda."
                    },
                    "comment": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 500,
                        "description": "Comentario del movimiento; obligatorio si lo exige el motivo de baja."
                    },
                    "lot_number": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 64,
                        "description": "En un ingreso de una variante con lotes — el lote; uno nuevo recibe expires_at. Sin número, la mercadería va a un lote nuevo con número automático, como en una recepción."
                    },
                    "expires_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date",
                        "description": "Fecha de vencimiento de un lote nuevo, en la zona horaria de la tienda."
                    },
                    "reason": {
                        "type": "string",
                        "enum": [
                            "restock",
                            "write_off"
                        ],
                        "description": "restock — llega mercadería, delta es positivo; write_off — la mercadería se da de baja por un motivo de la tienda (write_off_reason_id), delta es negativo."
                    },
                    "delta": {
                        "type": "string",
                        "pattern": "^-?\\d{1,15}(\\.\\d{1,15})?$",
                        "maxLength": 32,
                        "description": "Cambio del stock físico, como cadena decimal en la unidad de la variante. No se puede bajar el stock sin un motivo de baja: la corrección de un conteo erróneo va por fijar el stock."
                    },
                    "write_off_reason_id": {
                        "type": "integer",
                        "description": "En write_off — el motivo (/v1/write-off-reasons); debe ser selectable."
                    }
                },
                "required": [
                    "variant_id",
                    "location_id",
                    "reason",
                    "delta"
                ]
            },
            "AnnulFiscalDocumentRequest": {
                "type": "object",
                "properties": {
                    "reason": {
                        "type": "string",
                        "minLength": 3,
                        "maxLength": 500,
                        "description": "Por qué se anula la factura, con tus palabras, de 3 a 500 caracteres: va a la nota de anulación y al historial del pedido."
                    }
                },
                "required": [
                    "reason"
                ]
            },
            "BulkOperation": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID del registro, único entre los registros de su tipo en la tienda."
                    },
                    "app_id": {
                        "type": "integer",
                        "description": "ID de la aplicación que creó la operación."
                    },
                    "type": {
                        "type": "string",
                        "enum": [
                            "inventory.set",
                            "products.upsert",
                            "money_transactions.create",
                            "money_transactions.update",
                            "orders.export",
                            "libro_iva.export",
                            "accountant_package.export"
                        ],
                        "description": "Tipo de operación: inventory.set — fijar el stock; products.upsert — crear o actualizar productos con variantes; money_transactions.create — ingresos y gastos manuales; money_transactions.update — editar movimientos de dinero, por ejemplo asignar categorías; orders.export — exportar pedidos; libro_iva.export — los libros del Libro IVA Digital de una razón social para un mes; accountant_package.export — el paquete del contador de una razón social para un mes."
                    },
                    "status": {
                        "type": "string",
                        "enum": [
                            "pending",
                            "running",
                            "cancelling",
                            "completed",
                            "cancelled",
                            "failed"
                        ],
                        "description": "pending — espera para iniciar; running — en curso; cancelling — se detiene después de la línea actual; completed — se procesó toda la entrada o se generó el archivo; cancelled — cancelada; failed — se detuvo antes del final de la entrada o no generó el archivo (error)."
                    },
                    "input": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "properties": {
                            "source": {
                                "type": "string",
                                "enum": [
                                    "upload",
                                    "url"
                                ],
                                "description": "upload — una carga por partes (/v1/uploads); url — un archivo descargado desde una dirección."
                            },
                            "url": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "description": "Dirección desde la que se descarga la entrada; null en una carga."
                            },
                            "file_name": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "description": "Nombre del archivo cargado; null en una dirección."
                            },
                            "bytes": {
                                "type": [
                                    "integer",
                                    "null"
                                ],
                                "description": "Tamaño de la entrada en bytes, descomprimida si llegó en gzip; null mientras se desconoce."
                            },
                            "processed_bytes": {
                                "type": "integer",
                                "description": "Cuántos bytes de la entrada se procesaron: su proporción es el avance."
                            }
                        },
                        "required": [
                            "source",
                            "url",
                            "file_name",
                            "bytes",
                            "processed_bytes"
                        ],
                        "description": "La entrada de la operación: una carga por partes o una dirección. null en una exportación y en un archivo: no tienen entrada."
                    },
                    "params": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "additionalProperties": true,
                        "description": "Parámetros de la exportación o del archivo tal como los aceptó la creación: en orders.export, los filtros del listado GET /v1/orders (updated_since, number); en libro_iva.export, legal_entity_id, period y books; en accountant_package.export, legal_entity_id y period. null en una operación con entrada."
                    },
                    "lines": {
                        "type": "object",
                        "properties": {
                            "read": {
                                "type": "integer",
                                "description": "Líneas leídas."
                            },
                            "succeeded": {
                                "type": "integer",
                                "description": "Líneas procesadas con éxito."
                            },
                            "failed": {
                                "type": "integer",
                                "description": "Líneas rechazadas."
                            }
                        },
                        "required": [
                            "read",
                            "succeeded",
                            "failed"
                        ],
                        "description": "Líneas de la entrada: leídas (incluidas las vacías), ejecutadas con éxito y rechazadas. Una línea rechazada no detiene la operación; su motivo está en el resultado. En una exportación, los elementos del listado escritos en el resultado: read y succeeded son iguales, failed es 0. En un archivo, ceros: su resultado es status y su contenido es el archivo comprimido."
                    },
                    "error": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "properties": {
                            "code": {
                                "type": "string",
                                "enum": [
                                    "invalid_url",
                                    "blocked_address",
                                    "unreachable",
                                    "too_large",
                                    "access_denied",
                                    "not_found",
                                    "rate_limited",
                                    "http_error",
                                    "input_corrupt",
                                    "app_unavailable",
                                    "scope_revoked",
                                    "processing_failed",
                                    "capability_disabled",
                                    "locations_restricted",
                                    "legal_entity_deleted",
                                    "libro_iva_not_applicable",
                                    "libro_iva_incomplete"
                                ],
                                "description": "invalid_url, blocked_address, unreachable, too_large, access_denied, not_found, rate_limited, http_error — la entrada no se descargó (source_status ante una respuesta con error de su servidor); input_corrupt — la entrada no se puede leer, por ejemplo un gzip roto; app_unavailable — la aplicación se eliminó o perdió el acceso; scope_revoked — la aplicación perdió un scope que la operación necesita; capability_disabled — la tienda ya no tiene el libro fiscal que contiene los datos del archivo; locations_restricted — la aplicación quedó limitada a algunos locales y el archivo abarca toda la razón social; legal_entity_deleted — la razón social se eliminó después de crear la operación; libro_iva_not_applicable — la razón social no lleva el Libro IVA Digital; libro_iva_incomplete — hay comprobantes del período que no se pueden describir como registros del libro (documents); processing_failed — una falla interna."
                            },
                            "message": {
                                "type": "string",
                                "description": "El motivo en palabras, en el idioma de la solicitud."
                            },
                            "source_status": {
                                "type": [
                                    "integer",
                                    "null"
                                ],
                                "description": "Estado HTTP con el que respondió el servidor de la entrada, en access_denied, not_found, rate_limited y http_error; si no, null."
                            },
                            "documents": {
                                "type": [
                                    "array",
                                    "null"
                                ],
                                "items": {
                                    "type": "object",
                                    "properties": {
                                        "type": {
                                            "type": "string",
                                            "enum": [
                                                "fiscal_document",
                                                "supplier_bill"
                                            ],
                                            "description": "fiscal_document — un comprobante fiscal del libro de ventas; supplier_bill — un comprobante de proveedor del libro de compras o de importación."
                                        },
                                        "id": {
                                            "type": "integer",
                                            "description": "ID del registro, único entre los registros de su tipo en la tienda."
                                        },
                                        "reason": {
                                            "type": "string",
                                            "enum": [
                                                "missing_request",
                                                "missing_number",
                                                "unknown_document_type",
                                                "other_ledger_file",
                                                "broker_fields_required",
                                                "currency_code_unconfirmed",
                                                "unsupported_currency",
                                                "missing_exchange_rate",
                                                "invalid_vendor_tax_id",
                                                "unknown_tax_rate",
                                                "missing_despacho",
                                                "unknown_rate",
                                                "missing_import_document_kind",
                                                "missing_import_document_description",
                                                "unsupported_service_rate",
                                                "missing_import_tax_payment"
                                            ],
                                            "description": "Por qué no se puede describir: missing_request, missing_number — el comprobante fiscal no tiene la solicitud a ARCA o el número; unknown_document_type, other_ledger_file, broker_fields_required — el tipo de comprobante no corresponde a este libro o faltan los datos del corredor; currency_code_unconfirmed, unsupported_currency, missing_exchange_rate — la moneda no tiene código de ARCA o no tiene cotización; invalid_vendor_tax_id — CUIT del vendedor inválido; unknown_tax_rate — la alícuota no se puede desglosar; missing_despacho, unknown_rate — una importación de bienes no tiene número de despacho o alícuota; missing_import_document_kind, missing_import_document_description, unsupported_service_rate, missing_import_tax_payment — a una importación de servicios le falta el comprobante del prestador, la alícuota o el pago del impuesto."
                                        }
                                    },
                                    "required": [
                                        "type",
                                        "id",
                                        "reason"
                                    ]
                                },
                                "description": "En libro_iva_incomplete, los comprobantes del período que no se pueden describir como registros del libro; corregilos en la tienda y creá la operación de nuevo. Si no, null."
                            }
                        },
                        "required": [
                            "code",
                            "message",
                            "source_status",
                            "documents"
                        ],
                        "description": "En failed, por qué la operación no llegó al final de la entrada o no generó el archivo. En una en curso, la última falla de descarga de la entrada que todavía se reintenta. Si no, null."
                    },
                    "result_url": {
                        "type": "string",
                        "description": "La dirección del resultado: NDJSON, una línea por cada línea de la entrada en orden, con los resultados de las líneas ya procesadas; en una exportación, un elemento del listado por línea; en un archivo, el ZIP de la operación terminada. Se puede reanudar por rangos."
                    },
                    "result_scopes": {
                        "type": "array",
                        "items": {
                            "type": "string"
                        },
                        "description": "Scopes que necesita el resultado: la lectura de los datos del tipo y los scopes de campos con los que se creó la operación, como customers:read en una exportación de pedidos con datos de clientes. El conjunto se fija al crearla; quitar un scope detiene la operación (scope_revoked)."
                    },
                    "sync_cursor": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "En una exportación completada — el cursor de sincronización del listado del que se armó (GET /v1/orders con los mismos params): con él el listado devuelve lo que cambió después de la exportación. Si no, null."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo se creó el registro."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo cambió el registro por última vez."
                    },
                    "started_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Cuándo empezó la operación; null mientras está en pending."
                    },
                    "finished_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Cuándo terminó la operación; null hasta entonces."
                    }
                },
                "required": [
                    "id",
                    "app_id",
                    "type",
                    "status",
                    "input",
                    "params",
                    "lines",
                    "error",
                    "result_url",
                    "result_scopes",
                    "sync_cursor",
                    "created_at",
                    "updated_at",
                    "started_at",
                    "finished_at"
                ]
            },
            "CalculateRefundRequest": {
                "type": "object",
                "properties": {
                    "items": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "order_item_id": {
                                    "type": "integer",
                                    "minimum": 1,
                                    "description": "ID del ítem del pedido (items en /v1/orders)."
                                },
                                "quantity": {
                                    "type": "string",
                                    "maxLength": 32,
                                    "description": "Cantidad como cadena decimal en unit: unidades, o la medida completa de un ítem por peso o volumen."
                                }
                            },
                            "required": [
                                "order_item_id",
                                "quantity"
                            ]
                        },
                        "maxItems": 200,
                        "uniqueItems": true,
                        "description": "Ítems devueltos."
                    },
                    "shipping_amount": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 100000000000000,
                        "description": "Parte de amount que reembolsa el envío."
                    },
                    "irreversible_to": {
                        "type": "string",
                        "enum": [
                            "manual",
                            "balance"
                        ],
                        "description": "A dónde va la parte de un medio irreversible (transferencia, cripto, medio manual): manual — la tienda la devuelve a mano y la confirma (POST /v1/refunds/{refund}/confirm); balance — al saldo del cliente (balance_available del cálculo)."
                    }
                },
                "required": [
                    "items"
                ]
            },
            "CancelOrderRequest": {
                "type": "object",
                "properties": {
                    "status": {
                        "type": "string",
                        "maxLength": 50,
                        "description": "Estado del pedido: un código de la lista de estados de la tienda (/v1/order-statuses). La tienda puede agregar sus propios estados; status_group da el significado permanente."
                    },
                    "comment": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 500,
                        "description": "Motivo de la cancelación en palabras, queda en el historial del pedido."
                    }
                }
            },
            "Category": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID del registro, único entre los registros de su tipo en la tienda."
                    },
                    "external_id": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "ID externo: el ID del registro en tu sistema; null si la aplicación no lo fijó. Cada aplicación ve solo sus propios ID."
                    },
                    "version": {
                        "type": "integer",
                        "description": "Versión del registro: crece con cada cambio. Para cambiar el registro, envíela como ETag en If-Match."
                    },
                    "parent_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID de la categoría padre; null en una categoría de primer nivel. Las categorías llegan como lista plana; el árbol se arma con este campo."
                    },
                    "name": {
                        "type": "object",
                        "additionalProperties": {
                            "type": "string"
                        },
                        "description": "Nombre por idioma: un objeto con los idiomas completados, por ejemplo {\"es\": \"Café\", \"en\": \"Coffee\"}."
                    },
                    "description": {
                        "type": "object",
                        "additionalProperties": {
                            "type": "string"
                        },
                        "description": "Descripción por idioma en Markdown (GitHub Flavored): un objeto con los idiomas completados."
                    },
                    "slug": {
                        "type": "string",
                        "description": "Dirección de la categoría en la tienda online, única en la tienda."
                    },
                    "position": {
                        "type": "integer",
                        "description": "Posición entre las categorías hermanas: la menor va primero."
                    },
                    "is_active": {
                        "type": "boolean",
                        "description": "false oculta la categoría de la tienda online."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo se creó el registro."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo cambió el registro por última vez."
                    },
                    "deleted_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Cuándo se archivó la categoría; null en una categoría vigente."
                    }
                },
                "required": [
                    "id",
                    "external_id",
                    "version",
                    "parent_id",
                    "name",
                    "description",
                    "slug",
                    "position",
                    "is_active",
                    "created_at",
                    "updated_at",
                    "deleted_at"
                ]
            },
            "ChangeCustomerGroupMembersRequest": {
                "type": "object",
                "properties": {
                    "customer_ids": {
                        "type": "array",
                        "items": {
                            "type": "integer"
                        },
                        "minItems": 1,
                        "maxItems": 1000,
                        "uniqueItems": true,
                        "description": "IDs de clientes de la tienda, sin repetir, hasta 1000 por solicitud. Se omiten los que ya están en el grupo (al agregar) o no están (al quitar)."
                    }
                },
                "required": [
                    "customer_ids"
                ]
            },
            "CompleteDraftOrderRequest": {
                "type": "object",
                "properties": {
                    "mode": {
                        "type": "string",
                        "enum": [
                            "invoice",
                            "after_picking",
                            "mark_paid"
                        ],
                        "description": "invoice — el pedido espera el pago, los datos de pago van al cliente por los canales de la tienda, la página de pago está en payment_url del pago; after_picking — el cliente recibe la cuenta por el total exacto después de preparar el pedido, para mercadería por peso; mark_paid — el dinero ya se recibió por un medio manual, necesita el scope payments:write."
                    },
                    "expected_total": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 100000000000000,
                        "description": "El total que leíste en el borrador: precios, descuentos o envío pueden cambiar después de leerlo. Si es distinto, la solicitud recibe 422 y no se crea el pedido."
                    },
                    "currency": {
                        "type": "string",
                        "minLength": 3,
                        "maxLength": 3,
                        "description": "La moneda en la que leíste el total: el campo currency del borrador. Una tienda sin pedidos puede cambiar de moneda, y el cambio no toca los números de los precios; si la moneda es distinta, la solicitud recibe 422 y no se crea el pedido. Sin el campo la moneda no se verifica."
                    }
                },
                "required": [
                    "mode",
                    "expected_total"
                ]
            },
            "ConfirmPaymentRequest": {
                "type": "object",
                "properties": {
                    "comment": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 500,
                        "description": "Comentario de la confirmación, queda en el historial del pedido."
                    }
                }
            },
            "ConflictProblem": {
                "type": "object",
                "properties": {
                    "type": {
                        "type": "string",
                        "description": "Tipo técnico del problema: un código estable para decidir qué hacer, como insufficient_scope. Cada tipo tiene una página en el catálogo de errores."
                    },
                    "title": {
                        "type": "string",
                        "description": "Resumen breve del problema en el idioma de la solicitud."
                    },
                    "status": {
                        "type": "integer",
                        "description": "Estado HTTP de la respuesta."
                    },
                    "detail": {
                        "type": "string",
                        "description": "Explicación de este caso en el idioma de la solicitud."
                    },
                    "current": {
                        "type": "object",
                        "additionalProperties": true,
                        "description": "El registro tal como está ahora, los campos del conflicto: on_hand en stock_on_hand_changed, status en un cambio de pedido rechazado, status y order_id en un borrador cerrado."
                    },
                    "external_id": {
                        "type": "string",
                        "description": "En external_id_in_use y external_id_archived — el ID externo ocupado."
                    },
                    "consent_kind": {
                        "type": "string",
                        "description": "En consent_required — el tipo de consecuencia que hay que aceptar."
                    },
                    "consequences": {
                        "type": "object",
                        "additionalProperties": {
                            "type": "integer",
                            "minimum": 0
                        },
                        "description": "En consent_required — qué cambiará: tipo de datos → cantidad de registros."
                    },
                    "consent_token": {
                        "type": "string",
                        "description": "En consent_required — huella de las consecuencias mostradas. Repetí la solicitud con consent[<consent_kind>]=<consent_token>."
                    },
                    "variant_id": {
                        "type": "integer",
                        "description": "En consent_required de una línea de variante dentro de la escritura de un producto — la variante: el consentimiento se da al cambiar esa variante (PATCH /v1/variants/{variant})."
                    },
                    "limit": {
                        "type": "integer",
                        "minimum": 0,
                        "description": "En plan_limit_reached, address_book_full, bulk_operation_queue_full y webhook_endpoint_limit_reached — el límite."
                    },
                    "field": {
                        "type": "string",
                        "enum": [
                            "phone",
                            "email"
                        ],
                        "description": "En customer_contact_in_use — el contacto que pertenece a otro cliente: phone o email."
                    },
                    "existing_customer_id": {
                        "type": "integer",
                        "description": "En customer_contact_in_use — el cliente al que pertenece el contacto."
                    },
                    "received": {
                        "type": "integer",
                        "minimum": 0,
                        "description": "En upload_offset_mismatch — bytes que ya recibió la carga: el desplazamiento desde el que continuar."
                    },
                    "operation_status": {
                        "type": "string",
                        "description": "En bulk_operation_finished — el estado con el que terminó la operación."
                    }
                },
                "required": [
                    "type",
                    "title",
                    "status"
                ]
            },
            "ConsignmentLossPolicy": {
                "type": "string",
                "enum": [
                    "return_to_supplier",
                    "our_cost"
                ]
            },
            "ConsignmentSettlement": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID del registro, único entre los registros de su tipo en la tienda."
                    },
                    "number": {
                        "type": "string",
                        "description": "Número de la liquidación."
                    },
                    "status": {
                        "type": "string",
                        "enum": [
                            "draft",
                            "posted",
                            "void"
                        ],
                        "description": "draft — el período está armado para revisar, las ventas todavía no quedan fijadas y el período puede cambiar; posted — acordada con el proveedor: las ventas del período quedan fijadas en ella y se le puede emitir un comprobante; void — anulada: sus ventas se liberan y entran en la próxima liquidación."
                    },
                    "supplier_id": {
                        "type": "integer",
                        "description": "ID del proveedor (/v1/suppliers)."
                    },
                    "legal_entity_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Razón social de la tienda a la que factura el proveedor (/v1/legal-entities); null en liquidaciones antiguas: la razón social predeterminada."
                    },
                    "supplier_bill_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Comprobante emitido por la liquidación (/v1/supplier-bills); null — todavía sin comprobante o el comprobante se anuló y la liquidación se puede volver a facturar. El comprobante anulado conserva el vínculo en su consignment_settlement_id."
                    },
                    "currency": {
                        "type": "string",
                        "description": "Moneda de la liquidación, ISO 4217 — la de los precios de compra: en ella están los precios e importes de las líneas y el total."
                    },
                    "period_from": {
                        "type": "string",
                        "description": "Primer día del período, YYYY-MM-DD."
                    },
                    "period_to": {
                        "type": "string",
                        "description": "Último día del período, YYYY-MM-DD."
                    },
                    "subtotal": {
                        "type": "integer",
                        "description": "Total de la liquidación en su moneda — la suma de las líneas, lo que factura el proveedor."
                    },
                    "base_subtotal": {
                        "type": "integer",
                        "description": "El mismo total en la moneda de la tienda."
                    },
                    "sections": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "kind": {
                                    "type": "string",
                                    "enum": [
                                        "sale",
                                        "loss",
                                        "price_adjustment"
                                    ],
                                    "description": "sale — vendido; loss — mercadería vencida o faltante que la tienda paga según la política del proveedor; price_adjustment — diferencia por un precio corregido en la recepción después de devengar la mercadería."
                                },
                                "subtotal": {
                                    "type": "integer",
                                    "description": "Subtotal de la sección en la moneda de la liquidación."
                                }
                            },
                            "required": [
                                "kind",
                                "subtotal"
                            ]
                        },
                        "description": "Subtotales por sección en el orden del documento; las secciones vacías no aparecen."
                    },
                    "lines": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "id": {
                                    "type": "integer",
                                    "description": "ID del registro, único entre los registros de su tipo en la tienda."
                                },
                                "position": {
                                    "type": "integer",
                                    "description": "Número de línea en el documento."
                                },
                                "kind": {
                                    "type": "string",
                                    "enum": [
                                        "sale",
                                        "loss",
                                        "price_adjustment"
                                    ],
                                    "description": "Sección de la línea, con los códigos de sections[].kind."
                                },
                                "variant_id": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "ID de la variante del producto (/v1/variants)."
                                },
                                "lot_id": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "Lote de la línea (/v1/lots); null en un producto sin lotes."
                                },
                                "goods_receipt_id": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "Recepción con la que llegó la mercadería (/v1/goods-receipts)."
                                },
                                "name": {
                                    "type": "string",
                                    "description": "Nombre del artículo como figura en el documento: se toma al armar la liquidación y no cambia si después se renombra el producto."
                                },
                                "sku": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "description": "SKU de la variante tomado junto con el nombre; null si no tiene."
                                },
                                "unit": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "description": "Unidad base de la cantidad de la línea: pcs — unidades, g — gramos, ml — mililitros."
                                },
                                "quantity": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "description": "Cantidad vendida, dada de baja o reajustada, como cadena decimal en la unidad base; una venta anulada dentro del período se descuenta."
                                },
                                "unit_cost": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "Precio de compra en la moneda de la liquidación por cost_per_quantity; en una línea price_adjustment — el precio nuevo. null — la recepción no tiene precio y la línea se devenga en cero."
                                },
                                "cost_per_quantity": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "description": "Cantidad en la unidad base a la que corresponde el precio: \"1000\" en un producto pesable significa por kilogramo."
                                },
                                "amount": {
                                    "type": "integer",
                                    "description": "Importe de la línea en la moneda de la liquidación; en una línea price_adjustment — la diferencia con lo ya devengado. Las líneas suman subtotal."
                                },
                                "base_amount": {
                                    "type": "integer",
                                    "description": "Importe de la línea en la moneda de la tienda."
                                }
                            },
                            "required": [
                                "id",
                                "position",
                                "kind",
                                "variant_id",
                                "lot_id",
                                "goods_receipt_id",
                                "name",
                                "sku",
                                "unit",
                                "quantity",
                                "unit_cost",
                                "cost_per_quantity",
                                "amount",
                                "base_amount"
                            ]
                        },
                        "description": "Líneas de la liquidación en el orden del documento: variante × recepción × precio."
                    },
                    "note": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Nota del personal; null si no hay."
                    },
                    "posted_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Cuándo se registró la liquidación; null en un borrador."
                    },
                    "voided_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Cuándo se anuló la liquidación; null si está vigente."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo se creó el registro."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo cambió el registro por última vez."
                    }
                },
                "required": [
                    "id",
                    "number",
                    "status",
                    "supplier_id",
                    "legal_entity_id",
                    "supplier_bill_id",
                    "currency",
                    "period_from",
                    "period_to",
                    "subtotal",
                    "base_subtotal",
                    "sections",
                    "lines",
                    "note",
                    "posted_at",
                    "voided_at",
                    "created_at",
                    "updated_at"
                ]
            },
            "CreateBulkOperationRequest": {
                "type": "object",
                "properties": {
                    "type": {
                        "type": "string",
                        "enum": [
                            "inventory.set",
                            "products.upsert",
                            "money_transactions.create",
                            "money_transactions.update",
                            "orders.export",
                            "libro_iva.export",
                            "accountant_package.export"
                        ],
                        "description": "Tipo de operación: inventory.set — fijar el stock; products.upsert — crear o actualizar productos con variantes; money_transactions.create — ingresos y gastos manuales; money_transactions.update — editar movimientos de dinero, por ejemplo asignar categorías; orders.export — exportar pedidos; libro_iva.export — los libros del Libro IVA Digital de una razón social para un mes; accountant_package.export — el paquete del contador de una razón social para un mes."
                    },
                    "input": {
                        "type": "object",
                        "properties": {
                            "upload_id": {
                                "type": "integer",
                                "minimum": 1,
                                "description": "ID de una carga por partes ya armada (/v1/uploads)."
                            },
                            "url": {
                                "type": "string",
                                "maxLength": 2048,
                                "description": "Dirección desde la que se descarga la entrada; null en una carga."
                            }
                        },
                        "description": "La entrada de la operación: una carga por partes o una dirección. null en una exportación y en un archivo: no tienen entrada."
                    },
                    "params": {
                        "type": "object",
                        "properties": {
                            "updated_since": {
                                "type": "string",
                                "format": "date-time",
                                "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?(Z|[+-]\\d{2}:\\d{2})$",
                                "description": "En orders.export — los pedidos cambiados después de este momento."
                            },
                            "include_deleted": {
                                "type": "boolean",
                                "description": "En orders.export — también los pedidos eliminados."
                            },
                            "number": {
                                "type": "string",
                                "maxLength": 16,
                                "description": "En orders.export — solo el pedido con este número."
                            },
                            "legal_entity_id": {
                                "type": "integer",
                                "description": "En libro_iva.export y accountant_package.export: la razón social cuyo archivo se genera."
                            },
                            "period": {
                                "type": "string",
                                "description": "En libro_iva.export y accountant_package.export: el mes con formato YYYY-MM, no posterior al mes actual de la tienda."
                            },
                            "books": {
                                "type": "array",
                                "items": {
                                    "type": "string",
                                    "enum": [
                                        "ventas",
                                        "compras"
                                    ]
                                },
                                "minItems": 1,
                                "maxItems": 2,
                                "uniqueItems": true,
                                "description": "En libro_iva.export: los libros, ventas y compras (las compras con los archivos de importación), uno o ambos."
                            }
                        },
                        "description": "Parámetros de la exportación o del archivo tal como los aceptó la creación: en orders.export, los filtros del listado GET /v1/orders (updated_since, number); en libro_iva.export, legal_entity_id, period y books; en accountant_package.export, legal_entity_id y period. null en una operación con entrada."
                    }
                },
                "required": [
                    "type"
                ]
            },
            "CreateCategoryRequest": {
                "type": "object",
                "properties": {
                    "name": {
                        "type": "object",
                        "additionalProperties": {
                            "type": [
                                "string",
                                "null"
                            ],
                            "maxLength": 255
                        },
                        "description": "Nombre por idioma: un objeto con los idiomas completados, por ejemplo {\"es\": \"Café\", \"en\": \"Coffee\"}."
                    },
                    "description": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "additionalProperties": {
                            "type": [
                                "string",
                                "null"
                            ],
                            "maxLength": 50000
                        },
                        "description": "Descripción por idioma en Markdown (GitHub Flavored): un objeto con los idiomas completados."
                    },
                    "slug": {
                        "type": "string",
                        "maxLength": 120,
                        "description": "Dirección de la categoría en la tienda online, única en la tienda."
                    },
                    "parent_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID de la categoría padre; null en una categoría de primer nivel. Las categorías llegan como lista plana; el árbol se arma con este campo."
                    },
                    "position": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 2147483647,
                        "description": "Posición entre las categorías hermanas: la menor va primero."
                    },
                    "is_active": {
                        "type": "boolean",
                        "description": "false oculta la categoría de la tienda online."
                    },
                    "external_id": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "ID externo: el ID del registro en tu sistema; null si la aplicación no lo fijó. Cada aplicación ve solo sus propios ID."
                    }
                },
                "required": [
                    "name"
                ]
            },
            "CreateCustomerAddressRequest": {
                "type": "object",
                "properties": {
                    "label": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 64,
                        "description": "Nombre de la dirección, como Casa o Trabajo; null si no se indicó."
                    },
                    "street": {
                        "type": "string",
                        "maxLength": 255,
                        "description": "Calle."
                    },
                    "house": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 32,
                        "description": "Número de la calle."
                    },
                    "apartment": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 32,
                        "description": "Departamento u oficina."
                    },
                    "floor": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 16,
                        "description": "Piso."
                    },
                    "entrance": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 16,
                        "description": "Entrada."
                    },
                    "district": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 64,
                        "description": "Barrio."
                    },
                    "postal_code": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 16,
                        "description": "Código postal."
                    },
                    "comment": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 500,
                        "description": "Comentario para el cadete, como la forma de entrar; null si no se indicó."
                    },
                    "location": {
                        "type": "object",
                        "properties": {
                            "lat": {
                                "type": "number",
                                "minimum": -90,
                                "maximum": 90,
                                "description": "Latitud en grados."
                            },
                            "lng": {
                                "type": "number",
                                "minimum": -180,
                                "maximum": 180,
                                "description": "Longitud en grados."
                            }
                        },
                        "required": [
                            "lat",
                            "lng"
                        ],
                        "description": "Ubicación de la dirección en el mapa; null si la dirección vino de otro sistema y aún no se ubicó."
                    },
                    "is_default": {
                        "type": "boolean",
                        "description": "La dirección principal del cliente. Si se elimina la principal, pasa a serlo la más reciente."
                    }
                },
                "required": [
                    "street",
                    "location"
                ]
            },
            "CreateCustomerGroupRequest": {
                "type": "object",
                "properties": {
                    "name": {
                        "type": "string",
                        "maxLength": 120,
                        "description": "Nombre del grupo, hasta 120 caracteres; único en la tienda sin distinguir mayúsculas."
                    },
                    "description": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 500,
                        "description": "Descripción para el personal, hasta 500 caracteres; null o sin el campo significa sin descripción."
                    },
                    "is_active": {
                        "type": "boolean",
                        "description": "Si el grupo está activo; true por defecto."
                    }
                },
                "required": [
                    "name"
                ]
            },
            "CreateCustomerRequest": {
                "type": "object",
                "properties": {
                    "name": {
                        "type": "string",
                        "pattern": "\\S",
                        "maxLength": 120,
                        "description": "Nombre del cliente; null si se desconoce."
                    },
                    "language": {
                        "$ref": "#/components/schemas/Locale",
                        "description": "Idioma en el que la tienda le escribe al cliente: ru, en o es."
                    },
                    "phone": {
                        "type": "string",
                        "maxLength": 32,
                        "description": "Teléfono principal del cliente en formato E.164, por ejemplo +5491123456789; null si se desconoce."
                    },
                    "email": {
                        "type": "string",
                        "maxLength": 254,
                        "description": "Email del cliente; null si se desconoce."
                    },
                    "external_id": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "ID externo del cliente, su ID en tu sistema; null si no está definido. Después de fusionar dos clientes, el ID del fusionado también encuentra al que queda; la respuesta muestra el ID principal."
                    }
                },
                "required": [
                    "name"
                ]
            },
            "CreateDraftOrderRequest": {
                "type": "object",
                "properties": {
                    "customer_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "El cliente del borrador (/v1/customers); null hasta elegirlo."
                    },
                    "delivery_method_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Método de envío (/v1/delivery-methods); null hasta elegirlo."
                    },
                    "address_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Dirección de la libreta del cliente, para un método con envío; null hasta elegirla."
                    },
                    "pickup_location_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Punto de retiro para un método de retiro. Un método con un solo punto lo usa por su cuenta; con varios, el borrador debe nombrar uno."
                    },
                    "delivery_slots": {
                        "type": [
                            "array",
                            "null"
                        ],
                        "items": {
                            "type": "object",
                            "properties": {
                                "from": {
                                    "type": "string",
                                    "description": "Inicio de la franja."
                                },
                                "to": {
                                    "type": "string",
                                    "description": "Fin de la franja."
                                }
                            },
                            "required": [
                                "from",
                                "to"
                            ]
                        },
                        "maxItems": 50,
                        "description": "Franjas de entrega elegidas para un método que trabaja con franjas."
                    },
                    "delivery_cost_override": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "minimum": 0,
                        "maximum": 10000000000,
                        "description": "Precio de envío fijado a mano en lugar del cálculo del método; null — según las reglas del método."
                    },
                    "payment_method": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "enum": [
                            "cash",
                            "mercadopago",
                            "crypto",
                            "bybit",
                            "trc20",
                            "balance",
                            "modo",
                            "payway",
                            "mercadopago_qr",
                            "mercadopago_point",
                            "mercadopago_transfer",
                            "gift_card",
                            "subscription",
                            "deposit",
                            "external",
                            "manual",
                            "offset",
                            "on_account",
                            "exchange_credit",
                            "bonpunto",
                            "service_package",
                            null
                        ],
                        "description": "Medio de pago con el que se confirmará el borrador: de él dependen los descuentos por medio de pago y la compatibilidad con el envío."
                    },
                    "manual_payment_method_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "minimum": 1,
                        "description": "Medio de pago manual de la tienda cuando payment_method es manual; si no, null."
                    },
                    "promocode": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 64,
                        "description": "Cupón aplicado al borrador; null si no hay."
                    },
                    "customer_comment": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 1000,
                        "description": "Comentario del cliente al pedido. Solo con el scope customers:read."
                    },
                    "note": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 1000,
                        "description": "Nota interna de la tienda: pasa al pedido, el cliente no la ve."
                    },
                    "lines": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "id": {
                                    "type": "integer",
                                    "description": "ID de la línea en el borrador."
                                },
                                "variant_id": {
                                    "type": "integer",
                                    "description": "Variante de la línea; null en una línea libre."
                                },
                                "quantity": {
                                    "type": "string",
                                    "maxLength": 32,
                                    "description": "Cantidad como cadena decimal en unit: unidades en un ítem por unidad, la medida en un ítem por peso o volumen (\"480\" gramos)."
                                },
                                "modifiers": {
                                    "type": "array",
                                    "items": {
                                        "type": "object",
                                        "properties": {
                                            "option_id": {
                                                "type": "integer",
                                                "description": "ID de la opción del adicional."
                                            },
                                            "quantity": {
                                                "type": "integer",
                                                "minimum": 1,
                                                "maximum": 99,
                                                "description": "Cuántas veces se agrega el adicional."
                                            }
                                        },
                                        "required": [
                                            "option_id"
                                        ]
                                    },
                                    "maxItems": 50,
                                    "description": "Adicionales de la línea, como los toppings de un plato."
                                }
                            },
                            "required": [
                                "variant_id",
                                "quantity"
                            ]
                        },
                        "maxItems": 200,
                        "uniqueItems": true,
                        "description": "Ítems del borrador. Un borrador abierto se calcula en vivo según el catálogo, los descuentos y el envío; uno cerrado guarda sus ítems sin precios."
                    }
                }
            },
            "CreateModifierGroupRequest": {
                "type": "object",
                "properties": {
                    "name": {
                        "type": "object",
                        "additionalProperties": {
                            "type": [
                                "string",
                                "null"
                            ],
                            "maxLength": 255
                        },
                        "description": "Nombre por idioma: un objeto con los idiomas completados, por ejemplo {\"es\": \"Café\", \"en\": \"Coffee\"}."
                    },
                    "min_select": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 99,
                        "description": "Cuántas opciones debe elegir el cliente: 0 — el grupo es opcional. Un producto puede fijar su propia regla (selection_rule)."
                    },
                    "max_select": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "minimum": 1,
                        "maximum": 99,
                        "description": "Cuántas opciones se pueden elegir en total, con repeticiones; null — sin límite."
                    },
                    "is_active": {
                        "type": "boolean",
                        "description": "false — el grupo está apagado y no se ofrece en los productos."
                    },
                    "adds_ingredients": {
                        "type": "boolean",
                        "description": "Si las opciones del grupo cambian la composición del plato; con true, una opción sin composición propia deja desconocida la composición del ítem (alérgenos)."
                    },
                    "options": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "external_id": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "description": "ID externo: el ID del registro en tu sistema; null si la aplicación no lo fijó. Cada aplicación ve solo sus propios ID."
                                },
                                "name": {
                                    "type": "object",
                                    "additionalProperties": {
                                        "type": [
                                            "string",
                                            "null"
                                        ],
                                        "maxLength": 255
                                    },
                                    "description": "Nombre por idioma: un objeto con los idiomas completados, por ejemplo {\"es\": \"Café\", \"en\": \"Coffee\"}."
                                },
                                "price_delta": {
                                    "type": "integer",
                                    "minimum": -100000000,
                                    "maximum": 100000000,
                                    "description": "Recargo sobre el precio del ítem por porción de la opción, entero en unidades menores de la moneda de la tienda; negativo — un descuento. Un producto puede fijar su propio recargo por variante."
                                },
                                "max_quantity": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "minimum": 1,
                                    "maximum": 99,
                                    "description": "Cuántas veces se puede tomar la opción en un ítem; null — sin límite propio, rige solo el max_select del grupo."
                                },
                                "duration_minutes": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "minimum": 5,
                                    "maximum": 120,
                                    "description": "Cuántos minutos suma la opción a un servicio con turno, múltiplo de 5; null — ninguno. No aplica a otros tipos de ítems."
                                },
                                "is_active": {
                                    "type": "boolean",
                                    "description": "false — la opción está apagada y no se ofrece."
                                },
                                "is_default": {
                                    "type": "boolean",
                                    "description": "La opción viene preseleccionada: la tienda y el POS la marcan de entrada, y el servidor completa con ella un grupo obligatorio vacío."
                                },
                                "adds_ingredients": {
                                    "type": [
                                        "boolean",
                                        "null"
                                    ],
                                    "description": "Si esta opción cambia la composición; null — como el grupo (adds_ingredients)."
                                },
                                "recipe_per_variant": {
                                    "type": "boolean",
                                    "description": "El consumo depende del plato: sin composición general, la cantidad la fija la receta de cada variante (option_recipes); sin ella la opción no se ofrece en esa variante."
                                },
                                "nutrition": {
                                    "type": [
                                        "object",
                                        "null"
                                    ],
                                    "properties": {
                                        "kcal": {
                                            "type": "integer",
                                            "minimum": 0,
                                            "maximum": 1000000,
                                            "description": "Energía, kcal."
                                        },
                                        "protein_mg": {
                                            "type": "integer",
                                            "minimum": 0,
                                            "maximum": 100000000,
                                            "description": "Proteínas, mg."
                                        },
                                        "fat_mg": {
                                            "type": "integer",
                                            "minimum": 0,
                                            "maximum": 100000000,
                                            "description": "Grasas, mg."
                                        },
                                        "carbs_mg": {
                                            "type": "integer",
                                            "minimum": 0,
                                            "maximum": 100000000,
                                            "description": "Carbohidratos, mg."
                                        }
                                    },
                                    "description": "Valor nutricional de un uso de la opción declarado por la tienda: los cuatro números o null — entonces lo calcula la composición de la opción."
                                },
                                "recipe": {
                                    "type": "array",
                                    "items": {
                                        "type": "object",
                                        "properties": {
                                            "variant_id": {
                                                "type": "integer",
                                                "description": "ID de la variante del producto."
                                            },
                                            "quantity": {
                                                "type": [
                                                    "string",
                                                    "null"
                                                ],
                                                "maxLength": 32,
                                                "description": "Cantidad del componente por un uso de la opción, como texto decimal en la unidad del componente; null — a gusto: en la composición pero sin consumo."
                                            }
                                        },
                                        "required": [
                                            "variant_id",
                                            "quantity"
                                        ]
                                    },
                                    "maxItems": 100,
                                    "description": "Composición general de la opción — lo que consume en cualquier plato: insumos y preelaborados con su cantidad. Vacía en una opción por plato. Al escribir, la lista completa, una vacía la limpia; sin el campo la composición queda como está."
                                }
                            }
                        },
                        "minItems": 1,
                        "maxItems": 100,
                        "uniqueItems": true,
                        "description": "Opciones en orden de exhibición. Al escribir, el conjunto completo: una fila encuentra su opción por id o external_id, a la encontrada se le escriben los campos enviados, una fila sin opción es nueva y lleva name; una opción que falta en el conjunto se archiva y se quita de los borradores de pedido abiertos."
                    },
                    "external_id": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "ID externo: el ID del registro en tu sistema; null si la aplicación no lo fijó. Cada aplicación ve solo sus propios ID."
                    }
                },
                "required": [
                    "name",
                    "options"
                ]
            },
            "CreateMoneyTransactionRequest": {
                "type": "object",
                "properties": {
                    "account_id": {
                        "type": "integer",
                        "minimum": 1,
                        "description": "ID de la cuenta de dinero del movimiento."
                    },
                    "direction": {
                        "$ref": "#/components/schemas/MoneyTransactionDirection",
                        "description": "income — ingreso a la cuenta; expense — egreso de la cuenta."
                    },
                    "account_amount": {
                        "type": "string",
                        "maxLength": 37,
                        "description": "Importe en la moneda de la cuenta, como cadena decimal."
                    },
                    "amount": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "minimum": 0,
                        "maximum": 100000000000000,
                        "description": "Importe del asiento en unidades mínimas de la moneda de la tienda, siempre positivo: el signo lo da direction. En una cuenta en otra moneda, convertido al tipo de cambio de la foto."
                    },
                    "occurred_on": {
                        "type": "string",
                        "format": "date",
                        "description": "Fecha contable, YYYY-MM-DD en la zona horaria de la tienda."
                    },
                    "occurred_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Momento del movimiento."
                    },
                    "category_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID de la categoría; null en una transferencia entre cuentas o un movimiento sin categoría."
                    },
                    "supplier_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID del proveedor contraparte; null si no hay."
                    },
                    "description": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 1000,
                        "description": "Comentario del movimiento como lo escribió una persona o un documento; null si no hay."
                    }
                },
                "required": [
                    "account_id",
                    "direction",
                    "account_amount"
                ]
            },
            "CreateMoneyTransferRequest": {
                "type": "object",
                "properties": {
                    "from_account_id": {
                        "type": "integer",
                        "minimum": 1,
                        "description": "ID de la cuenta de dinero de la que salió el dinero."
                    },
                    "to_account_id": {
                        "type": "integer",
                        "minimum": 1,
                        "description": "ID de la cuenta de dinero a la que entró el dinero."
                    },
                    "from_amount": {
                        "type": "string",
                        "maxLength": 37,
                        "description": "Importe que salió de from_account_id en su moneda, como cadena decimal."
                    },
                    "to_amount": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 37,
                        "description": "Importe que entró en to_account_id en su moneda, como cadena decimal. En la misma moneda es igual a from_amount: la diferencia es la comisión fee."
                    },
                    "fee": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 37,
                        "description": "Comisión de la transferencia en la moneda de la cuenta de origen, como cadena decimal: un egreso en la categoría de sistema bank_fees; null si no hay comisión."
                    },
                    "occurred_on": {
                        "type": "string",
                        "format": "date",
                        "description": "Fecha contable de la transferencia, YYYY-MM-DD en la zona horaria de la tienda."
                    },
                    "occurred_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Momento de la transferencia."
                    },
                    "description": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 1000,
                        "description": "Descripción de la transferencia; null si no se cargó."
                    }
                },
                "required": [
                    "from_account_id",
                    "to_account_id",
                    "from_amount"
                ]
            },
            "CreatePriceListRequest": {
                "type": "object",
                "properties": {
                    "kind": {
                        "type": "string",
                        "enum": [
                            "wholesale"
                        ],
                        "description": "Tipo de lista: solo wholesale, mayorista. La lista de local la crea el local en el panel."
                    },
                    "name": {
                        "type": "string",
                        "maxLength": 120,
                        "description": "Nombre de la lista mayorista, hasta 120 caracteres: el panel lo muestra en la ficha del cliente."
                    },
                    "adjustment_bp": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 50000,
                        "description": "Margen sobre el costo en puntos básicos (1 % = 100), de 0 a 50000: 0 — al costo; una lista mayorista no vende por debajo del costo."
                    },
                    "rounding": {
                        "type": "object",
                        "properties": {
                            "mode": {
                                "$ref": "#/components/schemas/DiscountRoundingMode",
                                "description": "Cómo redondear: nearest — al más cercano, up — hacia arriba, down — hacia abajo."
                            },
                            "precision": {
                                "type": "integer",
                                "enum": [
                                    "1",
                                    "0",
                                    "-1",
                                    "-2",
                                    "-3",
                                    "-4",
                                    "-5",
                                    "-6",
                                    "2"
                                ],
                                "description": "Paso de redondeo en unidades menores de la moneda de la tienda; el paso de la propia unidad menor significa sin redondeo."
                            }
                        },
                        "description": "Redondeo del precio unitario, con mode y precision juntos. Sin el campo, la lista toma el redondeo de precios de la tienda."
                    }
                },
                "required": [
                    "kind",
                    "name",
                    "adjustment_bp"
                ]
            },
            "CreateProductMediaRequest": {
                "type": "object",
                "properties": {
                    "url": {
                        "type": "string",
                        "maxLength": 2048,
                        "description": "Dirección pública del archivo."
                    },
                    "position": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 10000,
                        "description": "Lugar en la galería, desde cero."
                    },
                    "is_primary": {
                        "type": "boolean",
                        "description": "La foto principal: la tienda online la muestra primero."
                    }
                },
                "required": [
                    "url"
                ]
            },
            "CreateProductRequest": {
                "type": "object",
                "properties": {
                    "name": {
                        "type": "object",
                        "additionalProperties": {
                            "type": [
                                "string",
                                "null"
                            ],
                            "maxLength": 255
                        },
                        "description": "Nombre por idioma: un objeto con los idiomas completados, por ejemplo {\"es\": \"Café\", \"en\": \"Coffee\"}."
                    },
                    "short_description": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "additionalProperties": {
                            "type": [
                                "string",
                                "null"
                            ],
                            "maxLength": 500
                        },
                        "description": "Descripción breve por idioma, texto plano para las listas de productos."
                    },
                    "description": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "additionalProperties": {
                            "type": [
                                "string",
                                "null"
                            ],
                            "maxLength": 50000
                        },
                        "description": "Descripción por idioma en Markdown (GitHub Flavored): un objeto con los idiomas completados."
                    },
                    "slug": {
                        "type": "string",
                        "maxLength": 160,
                        "description": "Dirección del producto en la tienda online, única en la tienda."
                    },
                    "brand_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID de la marca del producto; null si no está definida."
                    },
                    "tax_class_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID de la clase de impuesto del producto (/v1/tax-classes); null — la clase predeterminada de la tienda. Una venta conserva la alícuota de su ítem: un cambio de clase afecta solo a las ventas futuras."
                    },
                    "category_ids": {
                        "type": "array",
                        "items": {
                            "type": "integer"
                        },
                        "description": "ID de las categorías del producto, en orden ascendente."
                    },
                    "primary_category_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "La categoría principal entre category_ids; null si no se eligió una principal."
                    },
                    "is_active": {
                        "type": "boolean",
                        "description": "false retira el producto de la venta y lo oculta de la tienda online."
                    },
                    "published_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Cuándo aparece el producto en la tienda online; null — de inmediato."
                    },
                    "unpublished_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Cuándo sale el producto de la tienda online; null — se queda."
                    },
                    "sale_schedule": {
                        "type": [
                            "array",
                            "null"
                        ],
                        "items": {
                            "type": "object",
                            "properties": {
                                "days": {
                                    "type": "array",
                                    "items": {
                                        "type": "integer",
                                        "minimum": 1,
                                        "maximum": 7
                                    },
                                    "minItems": 1,
                                    "maxItems": 7,
                                    "description": "Días de la franja, ISO: 1 es lunes, 7 es domingo."
                                },
                                "from": {
                                    "type": "string",
                                    "pattern": "^(?:[01]\\d|2[0-3]):[0-5]\\d$|^24:00$",
                                    "description": "Inicio de la franja, «HH:MM» según el reloj del comercio."
                                },
                                "to": {
                                    "type": "string",
                                    "pattern": "^(?:[01]\\d|2[0-3]):[0-5]\\d$|^24:00$",
                                    "description": "Fin de la franja, «HH:MM», sin incluir ese momento; «24:00» — hasta el final del día. Un fin anterior al inicio hace que la franja pase la medianoche; pertenece a su día de inicio."
                                }
                            },
                            "required": [
                                "days",
                                "from",
                                "to"
                            ]
                        },
                        "maxItems": 14,
                        "description": "Cuándo se puede pedir el producto — franjas de la semana en la zona horaria del comercio; null — siempre. Fuera de la franja el producto sigue visible y se puede agregar al carrito, y el checkout compara el horario con el momento de entrega del pedido."
                    },
                    "type": {
                        "type": "string",
                        "enum": [
                            "goods",
                            "dish",
                            "ingredient",
                            "prep"
                        ],
                        "description": "Tipo de producto: goods — mercadería para la venta; dish — plato que se prepara al pedido; ingredient — materia prima para recetas; prep — semielaborado de preparación propia; manufactured — producción propia de la tienda; meal_program — plan de comidas por suscripción; bundle — combo de otros productos; gift_card — tarjeta de regalo; service — servicio con turno."
                    },
                    "stock_unit": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "properties": {
                            "unit": {
                                "type": "string",
                                "enum": [
                                    "g",
                                    "ml",
                                    "pcs"
                                ],
                                "description": "Unidad base: g — gramos, ml — mililitros, pcs — unidades. Las cantidades de las variantes del producto son textos decimales en esta unidad."
                            },
                            "purchase_unit": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "maxLength": 16,
                                "description": "Nombre del envase de compra, por ejemplo kg o caja; null — el ítem se compra en su unidad base."
                            },
                            "purchase_quantity": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "maxLength": 32,
                                "description": "Cuántas unidades base hay en un envase de compra, como texto decimal: por ejemplo, 1000 para un kilo de un ítem que se lleva en gramos."
                            }
                        },
                        "description": "Unidad de stock de un ítem con stock por medida (insumo, preelaborado, producto fabricado): en ella se llevan el stock, las recetas y el rendimiento. null en mercadería y platos: su unidad es el eje de venta de la variante."
                    },
                    "external_id": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "ID externo: el ID del registro en tu sistema; null si la aplicación no lo fijó. Cada aplicación ve solo sus propios ID."
                    },
                    "variants": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "external_id": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "description": "ID externo de la variante, su ID en tu sistema: la clave con la que se encuentra la línea."
                                },
                                "sku": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "maxLength": 64,
                                    "description": "Código de artículo (SKU); null si no está definido."
                                },
                                "name": {
                                    "type": [
                                        "object",
                                        "null"
                                    ],
                                    "additionalProperties": {
                                        "type": [
                                            "string",
                                            "null"
                                        ],
                                        "maxLength": 255
                                    },
                                    "description": "Nombre de la variante por idioma, por ejemplo {\"es\": \"Grande\"}."
                                },
                                "price": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 10000000000,
                                    "description": "Precio por price_per_quantity unidades, entero en unidades mínimas de currency."
                                },
                                "track_inventory": {
                                    "type": "boolean",
                                    "description": "La tienda lleva el stock de la variante; false — se vende sin contar stock."
                                },
                                "is_active": {
                                    "type": "boolean",
                                    "description": "false retira la variante de la venta."
                                },
                                "position": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 2147483647,
                                    "description": "Posición entre las variantes del producto: la menor va primero."
                                },
                                "list_price": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 10000000000,
                                    "description": "Precio tal como lo fijó el dueño, en unidades mínimas de list_price_currency; null — el precio se fijó en la moneda de la tienda (price). En esa variante price lo calcula el sistema con la cotización de la lista y no se acepta en la entrada."
                                },
                                "list_price_currency": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "enum": [
                                        "ARS",
                                        "USD",
                                        "BRL",
                                        "CLP",
                                        "COP",
                                        "MXN",
                                        "PEN",
                                        "RUB",
                                        null
                                    ],
                                    "description": "Moneda del precio fijado (lista de la tienda en otra moneda); null — precio en la moneda de la tienda currency. En la entrada: la moneda de la lista de la tienda o currency."
                                },
                                "compare_at_price": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "maximum": 10000000000,
                                    "description": "Precio antes del descuento, se muestra tachado; null si no hay descuento."
                                },
                                "weight_grams": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "minimum": 0,
                                    "maximum": 2147483647,
                                    "description": "Peso para el envío en gramos; null si no está definido."
                                },
                                "length_mm": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "minimum": 0,
                                    "maximum": 2147483647,
                                    "description": "Largo del paquete en milímetros; null si no está definido."
                                },
                                "width_mm": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "minimum": 0,
                                    "maximum": 2147483647,
                                    "description": "Ancho del paquete en milímetros; null si no está definido."
                                },
                                "height_mm": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "minimum": 0,
                                    "maximum": 2147483647,
                                    "description": "Alto del paquete en milímetros; null si no está definido."
                                },
                                "sale_starts_at": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "format": "date-time",
                                    "description": "Cuándo empieza la oferta: compare_at_price se muestra desde ese momento; null — sin inicio."
                                },
                                "sale_ends_at": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "format": "date-time",
                                    "description": "Cuándo termina la oferta; null — sin fin."
                                },
                                "sold_by": {
                                    "type": "string",
                                    "enum": [
                                        "each",
                                        "weight",
                                        "volume"
                                    ],
                                    "description": "Cómo se vende la variante: each — por unidad; weight — por peso; volume — por volumen."
                                },
                                "price_per_quantity": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "maxLength": 32,
                                    "description": "Por cuántas unidades es el precio, como cadena decimal: una unidad, o 1000 para el precio por kilo de una variante por peso. null si una variante por peso o volumen no lo tiene definido."
                                },
                                "measure_step": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "maxLength": 32,
                                    "description": "Paso de la cantidad en un ítem de una variante por peso o volumen, en su unidad; null si no está definido."
                                },
                                "min_measure_qty": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "maxLength": 32,
                                    "description": "Cantidad mínima en un ítem de una variante por peso o volumen; null si no está definida."
                                },
                                "max_measure_qty": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "maxLength": 32,
                                    "description": "Cantidad máxima en un ítem de una variante por peso o volumen; null si no está definida."
                                },
                                "net_content": {
                                    "type": "object",
                                    "properties": {
                                        "quantity": {
                                            "type": "string",
                                            "maxLength": 32,
                                            "description": "Medida como cadena decimal en unit: \"500\", \"0.5\"."
                                        },
                                        "unit": {
                                            "type": "string",
                                            "enum": [
                                                "g",
                                                "ml"
                                            ],
                                            "description": "Unidad de la medida: g — gramos; ml — mililitros."
                                        }
                                    },
                                    "description": "Contenido neto de una unidad: paquete de 500 g, botella de 1000 ml. Un pack de varias unidades de otra variante lo toma de ella, una unidad envasada, de su propia medida; solo se puede escribir en una variante común por unidad. null en variantes por peso o volumen y en unidades sin contenido neto."
                                },
                                "barcodes": {
                                    "type": [
                                        "array",
                                        "null"
                                    ],
                                    "items": {
                                        "type": "object",
                                        "properties": {
                                            "type": {
                                                "type": "string",
                                                "enum": [
                                                    "ean13",
                                                    "ean8",
                                                    "upca",
                                                    "upce",
                                                    "code128",
                                                    "code39",
                                                    "gtin",
                                                    "itf",
                                                    "qr",
                                                    "datamatrix",
                                                    "other"
                                                ],
                                                "description": "Simbología: ean13, ean8, upca, upce, code128, code39, gtin, itf, qr, datamatrix u other."
                                            },
                                            "value": {
                                                "type": "string",
                                                "description": "El código de barras."
                                            },
                                            "is_primary": {
                                                "type": [
                                                    "boolean",
                                                    "null"
                                                ],
                                                "description": "El código de barras principal de la variante: lo imprimen las etiquetas y los tickets."
                                            }
                                        },
                                        "required": [
                                            "type",
                                            "value"
                                        ]
                                    },
                                    "maxItems": 20,
                                    "description": "Códigos de barras de la variante."
                                }
                            },
                            "required": [
                                "price"
                            ]
                        },
                        "minItems": 1,
                        "maxItems": 200,
                        "description": "Líneas de variantes escritas junto con la ficha. Una línea se encuentra por su external_id: la variante del producto con ese ID se cambia con los campos enviados; si no hay, se crea una; las variantes no mencionadas quedan como están. Crear un producto exige al menos una línea con precio."
                    }
                },
                "required": [
                    "name",
                    "variants"
                ]
            },
            "CreatePurchaseOrderRequest": {
                "type": "object",
                "properties": {
                    "supplier_id": {
                        "type": "integer",
                        "description": "ID del proveedor (/v1/suppliers)."
                    },
                    "location_id": {
                        "type": "integer",
                        "description": "Local donde se espera la entrega (/v1/locations)."
                    },
                    "legal_entity_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Razón social compradora de la tienda (/v1/legal-entities); null en una orden creada antes de que la tienda tuviera razones sociales."
                    },
                    "currency": {
                        "type": "string",
                        "enum": [
                            "ARS",
                            "USD",
                            "BRL",
                            "CLP",
                            "COP",
                            "MXN",
                            "PEN",
                            "RUB"
                        ],
                        "description": "Moneda de la orden, ISO 4217: en ella van los precios de las líneas y los totales."
                    },
                    "prices_include_tax": {
                        "type": "boolean",
                        "description": "true: los precios de las líneas incluyen impuestos; false: no los incluyen."
                    },
                    "expected_on": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date",
                        "description": "Cuándo la tienda espera la entrega, YYYY-MM-DD; null si no se fijó."
                    },
                    "note": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 2000,
                        "description": "Nota del personal; null si no hay."
                    },
                    "lines": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "variant_id": {
                                    "type": "integer",
                                    "description": "ID de la variante del producto (/v1/variants)."
                                },
                                "ordered_quantity": {
                                    "type": "string",
                                    "maxLength": 32,
                                    "description": "Cantidad pedida, texto decimal en la unidad base."
                                },
                                "unit_cost": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "minimum": 0,
                                    "maximum": 10000000000,
                                    "description": "Precio en la moneda de la orden por cost_per_quantity; null si no hay precio."
                                },
                                "cost_per_quantity": {
                                    "type": "string",
                                    "maxLength": 32,
                                    "description": "Cantidad en la unidad base a la que corresponde el precio: \"1000\" en un producto por peso es por kilo."
                                }
                            },
                            "required": [
                                "variant_id",
                                "ordered_quantity"
                            ]
                        },
                        "minItems": 1,
                        "maxItems": 500,
                        "uniqueItems": true,
                        "description": "Líneas de la orden en su orden."
                    }
                },
                "required": [
                    "supplier_id",
                    "location_id",
                    "currency",
                    "lines"
                ]
            },
            "CreateRecommendationRuleRequest": {
                "type": "object",
                "properties": {
                    "source_type": {
                        "$ref": "#/components/schemas/RecommendationRuleSource",
                        "description": "A qué se aplica la regla: category — productos de la categoría y sus subcategorías; collection — productos de la colección."
                    },
                    "source_id": {
                        "type": "integer",
                        "minimum": 1,
                        "description": "ID de la categoría o colección a cuyos productos se aplica la regla. Cada origen tiene una sola regla."
                    },
                    "target_collection_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID de la colección cuyos productos ofrece la regla después de los suyos; null — sin colección."
                    },
                    "product_ids": {
                        "type": "array",
                        "items": {
                            "type": "integer"
                        },
                        "maxItems": 20,
                        "uniqueItems": true,
                        "description": "ID de los productos que ofrece la regla, en el orden del estante; como máximo 20."
                    },
                    "exclusive": {
                        "type": "boolean",
                        "description": "true — «solo esta regla»: las reglas de abajo y la selección automática no completan el estante; sin productos ni colección oculta el estante."
                    },
                    "is_active": {
                        "type": "boolean",
                        "description": "false apaga la regla: se guarda pero no se aplica."
                    },
                    "position": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 2147483647,
                        "description": "Prioridad: la regla con el valor menor se aplica antes."
                    }
                },
                "required": [
                    "source_type",
                    "source_id"
                ]
            },
            "CreateRefundRequest": {
                "type": "object",
                "properties": {
                    "items": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "order_item_id": {
                                    "type": "integer",
                                    "minimum": 1,
                                    "description": "ID del ítem del pedido (items en /v1/orders)."
                                },
                                "quantity": {
                                    "type": "string",
                                    "maxLength": 32,
                                    "description": "Cantidad como cadena decimal en unit: unidades, o la medida completa de un ítem por peso o volumen."
                                }
                            },
                            "required": [
                                "order_item_id",
                                "quantity"
                            ]
                        },
                        "maxItems": 200,
                        "uniqueItems": true,
                        "description": "Ítems devueltos."
                    },
                    "shipping_amount": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 100000000000000,
                        "description": "Parte de amount que reembolsa el envío."
                    },
                    "irreversible_to": {
                        "type": "string",
                        "enum": [
                            "manual",
                            "balance"
                        ],
                        "description": "A dónde va la parte de un medio irreversible (transferencia, cripto, medio manual): manual — la tienda la devuelve a mano y la confirma (POST /v1/refunds/{refund}/confirm); balance — al saldo del cliente (balance_available del cálculo)."
                    },
                    "expected_amount": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 100000000000000,
                        "description": "El importe del cálculo (/v1/orders/{order}/refunds/calculate) que confirmás. Un descuento prorrateado, reembolsos anteriores o un cambio del pedido lo modifican después de leerlo; un reembolso por otro importe no se realiza."
                    }
                },
                "required": [
                    "items",
                    "expected_amount"
                ]
            },
            "CreateSupplierBillRequest": {
                "type": "object",
                "properties": {
                    "kind": {
                        "type": "string",
                        "enum": [
                            "invoice",
                            "debit_note",
                            "credit_note"
                        ],
                        "description": "invoice: factura; debit_note: nota de débito, aumenta la deuda; credit_note: nota de crédito, reduce la deuda (devolución, descuento, corrección). Los importes del comprobante son siempre positivos y el signo lo da kind."
                    },
                    "fiscal": {
                        "type": "boolean",
                        "description": "false: deuda por una entrega sin factura, sin datos de ARCA y fuera del libro de compras; true: factura o nota."
                    },
                    "legal_entity_id": {
                        "type": "integer",
                        "description": "ID de la razón social compradora de la tienda (/v1/legal-entities)."
                    },
                    "supplier_id": {
                        "type": "integer",
                        "description": "ID del proveedor (/v1/suppliers)."
                    },
                    "related_bill_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID del comprobante que corrige la nota; null en una factura y en una nota sin referencia."
                    },
                    "number": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 20,
                        "description": "Número del comprobante como lo cargó la tienda; null en una deuda sin factura."
                    },
                    "issued_on": {
                        "type": "string",
                        "format": "date",
                        "description": "Fecha del comprobante, YYYY-MM-DD en la zona horaria de la tienda."
                    },
                    "tax_period": {
                        "type": "string",
                        "description": "Período fiscal en el que el comprobante va al libro de compras, YYYY-MM."
                    },
                    "due_on": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date",
                        "description": "Vencimiento, YYYY-MM-DD en la zona horaria de la tienda; null: sin vencimiento."
                    },
                    "currency": {
                        "type": "string",
                        "enum": [
                            "ARS",
                            "USD",
                            "BRL",
                            "CLP",
                            "COP",
                            "MXN",
                            "PEN",
                            "RUB"
                        ],
                        "description": "Moneda del comprobante, ISO 4217: en ella están todos los importes salvo base_total."
                    },
                    "exchange_rate": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "pattern": "^\\d{1,14}(\\.\\d{1,10})?$",
                        "maxLength": 1000000000000,
                        "description": "Cotización de la moneda del comprobante a la de la tienda como cadena decimal; null en un comprobante en la moneda de la tienda."
                    },
                    "net_taxed": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 10000000000,
                        "description": "Neto gravado de IVA."
                    },
                    "net_exempt": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 10000000000,
                        "description": "Importe exento de IVA."
                    },
                    "net_untaxed": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 10000000000,
                        "description": "Importe no gravado de IVA."
                    },
                    "tax_total": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 10000000000,
                        "description": "IVA del comprobante."
                    },
                    "total": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 10000000000,
                        "description": "Total del comprobante: neto, impuestos y percepciones."
                    },
                    "note": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 2000,
                        "description": "Nota del personal; null si no hay."
                    },
                    "lines": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "description": {
                                    "type": "string",
                                    "maxLength": 300,
                                    "description": "Descripción de la línea como en el comprobante."
                                },
                                "variant_id": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "ID de la variante del producto (/v1/variants); null en una línea que no es de un producto."
                                },
                                "quantity": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "pattern": "^\\d{1,14}(\\.\\d{1,6})?$",
                                    "minLength": 0,
                                    "maxLength": 1000000000000,
                                    "description": "Cantidad como cadena decimal; null si no figura."
                                },
                                "unit_amount": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "minimum": 0,
                                    "maximum": 10000000000,
                                    "description": "Precio unitario sin impuestos; null si no figura."
                                },
                                "net_amount": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 10000000000,
                                    "description": "Importe de la línea sin impuestos."
                                },
                                "tax_kind": {
                                    "type": "string",
                                    "enum": [
                                        "taxed",
                                        "exempt",
                                        "untaxed"
                                    ],
                                    "description": "taxed: gravado a una alícuota; exempt: exento; untaxed: no gravado."
                                },
                                "rate_bps": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 10000,
                                    "description": "Alícuota de IVA en puntos básicos: 2100 es 21 %."
                                },
                                "tax_amount": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 10000000000,
                                    "description": "IVA de la línea."
                                }
                            },
                            "required": [
                                "description",
                                "net_amount",
                                "tax_kind"
                            ]
                        },
                        "maxItems": 500,
                        "description": "Líneas del comprobante en orden; un comprobante cargado por totales no tiene líneas."
                    },
                    "additional_taxes": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "kind": {
                                    "type": "string",
                                    "enum": [
                                        "perception",
                                        "withholding",
                                        "internal",
                                        "other"
                                    ],
                                    "description": "perception: percepción, aumenta el importe a pagar y la tienda la computa; withholding: retención, la tienda la retiene al pagar y la ingresa al fisco, el importe transferido baja; internal: impuestos internos; other: otros tributos."
                                },
                                "regime": {
                                    "type": "string",
                                    "enum": [
                                        "vat",
                                        "income",
                                        "turnover",
                                        "municipal",
                                        "internal",
                                        "social",
                                        "other"
                                    ],
                                    "description": "Qué impuesto: vat: IVA; income: Ganancias; turnover: Ingresos Brutos; municipal: tasas municipales, y otros."
                                },
                                "jurisdiction": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "pattern": "^[A-Z]{2}-[A-Z0-9]{1,5}$",
                                    "maxLength": 8,
                                    "description": "Jurisdicción del impuesto, por ejemplo la provincia de Ingresos Brutos; null si el impuesto no la necesita."
                                },
                                "amount": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 10000000000,
                                    "description": "Importe del impuesto."
                                },
                                "certificate_number": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "maxLength": 64,
                                    "description": "Número del certificado de retención o percepción; null si no hay."
                                }
                            },
                            "required": [
                                "kind",
                                "regime",
                                "amount"
                            ]
                        },
                        "maxItems": 50,
                        "description": "Impuestos además del IVA: percepciones, retenciones, internos y otros. El comprobante solo trae su importe, sin base ni alícuota."
                    },
                    "goods_receipt_ids": {
                        "type": "array",
                        "items": {
                            "type": "integer"
                        },
                        "maxItems": 100,
                        "description": "Recepciones que cubre el documento (/v1/goods-receipts): entregas conciliadas con la factura o la entrega de una deuda por entrega."
                    },
                    "purchase_order_ids": {
                        "type": "array",
                        "items": {
                            "type": "integer"
                        },
                        "maxItems": 100,
                        "description": "Órdenes de compra a las que corresponde el documento (/v1/purchase-orders)."
                    },
                    "supplier_return_ids": {
                        "type": "array",
                        "items": {
                            "type": "integer"
                        },
                        "maxItems": 100,
                        "description": "Devoluciones a proveedores por las que se emitió la nota de crédito (/v1/supplier-returns)."
                    },
                    "ar": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "properties": {
                            "document_type_code": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "maxLength": 3,
                                "description": "Código de tipo de comprobante de ARCA: 001: factura A; 006: factura B; 011: factura C; null si no figura."
                            },
                            "point_of_sale": {
                                "type": [
                                    "integer",
                                    "null"
                                ],
                                "minimum": 0,
                                "maximum": 99999,
                                "description": "Punto de venta del proveedor; null si no figura."
                            },
                            "authorization_kind": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "enum": [
                                    "CAE",
                                    "CAEA",
                                    "CAI",
                                    null
                                ],
                                "description": "CAE: comprobante electrónico; CAEA: código otorgado por período; CAI: talonario impreso; null: sin autorización (por ejemplo, un comprobante del exterior)."
                            },
                            "authorization_code": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "maxLength": 14,
                                "description": "Código de autorización; null si no figura."
                            },
                            "authorization_expires_on": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "format": "date",
                                "description": "Vencimiento del código de autorización, YYYY-MM-DD; null si no figura."
                            },
                            "credit_fiscal_amount": {
                                "type": [
                                    "integer",
                                    "null"
                                ],
                                "minimum": 0,
                                "maximum": 10000000000,
                                "description": "Parte computable del IVA con prorrateo del crédito fiscal; null: se computa todo el impuesto."
                            },
                            "import": {
                                "type": [
                                    "object",
                                    "null"
                                ],
                                "properties": {
                                    "kind": {
                                        "type": "string",
                                        "enum": [
                                            "goods",
                                            "services"
                                        ],
                                        "description": "goods: importación de bienes con despacho; services: servicios de un prestador del exterior."
                                    },
                                    "customs_declaration": {
                                        "type": [
                                            "string",
                                            "null"
                                        ],
                                        "maxLength": 16,
                                        "description": "Número de despacho de la importación de bienes; null si no se indicó."
                                    },
                                    "document_kind": {
                                        "type": [
                                            "string",
                                            "null"
                                        ],
                                        "enum": [
                                            "invoice",
                                            "contract",
                                            "other",
                                            null
                                        ],
                                        "description": "Documento del prestador: invoice (factura), contract (contrato) u other (otro, con descripción); null si no se indicó."
                                    },
                                    "document_description": {
                                        "type": [
                                            "string",
                                            "null"
                                        ],
                                        "maxLength": 20,
                                        "description": "Descripción del documento de tipo other; null en los demás."
                                    },
                                    "provider_tax_id": {
                                        "type": [
                                            "string",
                                            "null"
                                        ],
                                        "maxLength": 20,
                                        "description": "Identificación fiscal del prestador en su país; null si no se indicó."
                                    },
                                    "tax_paid_on": {
                                        "type": [
                                            "string",
                                            "null"
                                        ],
                                        "format": "date",
                                        "description": "Fecha de pago del IVA por la importación de servicios, YYYY-MM-DD; null si no se indicó."
                                    },
                                    "tax_paid_amount": {
                                        "type": [
                                            "integer",
                                            "null"
                                        ],
                                        "minimum": 0,
                                        "maximum": 10000000000,
                                        "description": "IVA pagado por la importación de servicios en la moneda del documento; null si no se indicó."
                                    },
                                    "payment_reference": {
                                        "type": [
                                            "string",
                                            "null"
                                        ],
                                        "maxLength": 20,
                                        "description": "Identificación del pago del impuesto; null si no se indicó."
                                    },
                                    "payment_entity_tax_id": {
                                        "type": [
                                            "string",
                                            "null"
                                        ],
                                        "maxLength": 11,
                                        "description": "CUIT del banco por el que se ingresó el impuesto; null si no se indicó."
                                    }
                                },
                                "description": "Importación de bienes o servicios, con su propio diseño del libro de importaciones de ARCA; null en un documento local."
                            }
                        },
                        "description": "Datos de ARCA de la factura o nota; null en una deuda por entrega sin factura."
                    }
                },
                "required": [
                    "kind",
                    "fiscal",
                    "legal_entity_id",
                    "supplier_id",
                    "issued_on",
                    "currency",
                    "total"
                ]
            },
            "CreateSupplierRequest": {
                "type": "object",
                "properties": {
                    "name": {
                        "type": "string",
                        "maxLength": 200,
                        "description": "Nombre del proveedor como lo ve la tienda."
                    },
                    "tax_id": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 32,
                        "description": "Número fiscal como lo cargó la tienda (CUIT en Argentina); null si no está cargado."
                    },
                    "tax_id_country": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "enum": [
                            "AR",
                            "BR",
                            "CL",
                            "CO",
                            "MX",
                            "PE",
                            "RU",
                            null
                        ],
                        "description": "País del número fiscal, ISO 3166-1 alfa-2; null si el número no está cargado."
                    },
                    "legal_name": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 200,
                        "description": "Razón social; null si no está cargada."
                    },
                    "settlement_mode": {
                        "$ref": "#/components/schemas/SupplierSettlementMode",
                        "description": "on_receipt: compra común, la deuda nace con la recepción; on_sale: consignación, la tienda paga lo vendido según la liquidación de consignación."
                    },
                    "consignment_loss_policy": {
                        "$ref": "#/components/schemas/ConsignmentLossPolicy",
                        "description": "Quién paga la mercadería en consignación vencida o faltante: return_to_supplier: a cargo del proveedor, con devolución de la mercadería; our_cost: pérdida de la tienda."
                    },
                    "prices_include_tax": {
                        "type": [
                            "boolean",
                            "null"
                        ],
                        "description": "true: el proveedor cotiza con impuestos; false: sin impuestos; null: según la regla de la tienda."
                    },
                    "payment_term_days": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "minimum": 0,
                        "maximum": 365,
                        "description": "Plazo de pago en días: con él se calcula el vencimiento due_on del comprobante. null: sin plazo."
                    },
                    "min_order_amount": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "maximum": 100000000000000,
                        "description": "Monto mínimo de pedido en unidades mínimas de currency; null: sin mínimo."
                    },
                    "lead_time_days": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "minimum": 1,
                        "maximum": 365,
                        "description": "Plazo de entrega en días desde el pedido; null si no está cargado."
                    },
                    "is_active": {
                        "type": "boolean",
                        "description": "false: el proveedor está desactivado; no se le hacen pedidos nuevos y los documentos quedan."
                    },
                    "currency": {
                        "type": "string",
                        "enum": [
                            "ARS",
                            "USD",
                            "BRL",
                            "CLP",
                            "COP",
                            "MXN",
                            "PEN",
                            "RUB"
                        ],
                        "description": "Moneda de compra con el proveedor, ISO 4217: en ella están min_order_amount y los precios de sus pedidos."
                    },
                    "external_id": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "ID externo: el ID del registro en tu sistema; null si la aplicación no lo fijó. Cada aplicación ve solo sus propios ID."
                    }
                },
                "required": [
                    "name"
                ]
            },
            "CreateUploadRequest": {
                "type": "object",
                "properties": {
                    "file_name": {
                        "type": "string",
                        "maxLength": 255,
                        "description": "Nombre del archivo dado al iniciar la carga."
                    },
                    "size": {
                        "type": "integer",
                        "minimum": 1,
                        "maximum": 268435456,
                        "description": "Tamaño del archivo completo en bytes."
                    }
                },
                "required": [
                    "file_name",
                    "size"
                ]
            },
            "CreateVariantRequest": {
                "type": "object",
                "properties": {
                    "product_id": {
                        "type": "integer",
                        "description": "ID del producto."
                    },
                    "external_id": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "ID externo: el ID del registro en tu sistema; null si la aplicación no lo fijó. Cada aplicación ve solo sus propios ID."
                    },
                    "sku": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 64,
                        "description": "Código de artículo (SKU); null si no está definido."
                    },
                    "name": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "additionalProperties": {
                            "type": [
                                "string",
                                "null"
                            ],
                            "maxLength": 255
                        },
                        "description": "Nombre de la variante por idioma, por ejemplo {\"es\": \"Grande\"}."
                    },
                    "price": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 10000000000,
                        "description": "Precio por price_per_quantity unidades, entero en unidades mínimas de currency."
                    },
                    "track_inventory": {
                        "type": "boolean",
                        "description": "La tienda lleva el stock de la variante; false — se vende sin contar stock."
                    },
                    "is_active": {
                        "type": "boolean",
                        "description": "false retira la variante de la venta."
                    },
                    "position": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 2147483647,
                        "description": "Posición entre las variantes del producto: la menor va primero."
                    },
                    "list_price": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 10000000000,
                        "description": "Precio tal como lo fijó el dueño, en unidades mínimas de list_price_currency; null — el precio se fijó en la moneda de la tienda (price). En esa variante price lo calcula el sistema con la cotización de la lista y no se acepta en la entrada."
                    },
                    "list_price_currency": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "enum": [
                            "ARS",
                            "USD",
                            "BRL",
                            "CLP",
                            "COP",
                            "MXN",
                            "PEN",
                            "RUB",
                            null
                        ],
                        "description": "Moneda del precio fijado (lista de la tienda en otra moneda); null — precio en la moneda de la tienda currency. En la entrada: la moneda de la lista de la tienda o currency."
                    },
                    "compare_at_price": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "maximum": 10000000000,
                        "description": "Precio antes del descuento, se muestra tachado; null si no hay descuento."
                    },
                    "weight_grams": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "minimum": 0,
                        "maximum": 2147483647,
                        "description": "Peso para el envío en gramos; null si no está definido."
                    },
                    "length_mm": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "minimum": 0,
                        "maximum": 2147483647,
                        "description": "Largo del paquete en milímetros; null si no está definido."
                    },
                    "width_mm": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "minimum": 0,
                        "maximum": 2147483647,
                        "description": "Ancho del paquete en milímetros; null si no está definido."
                    },
                    "height_mm": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "minimum": 0,
                        "maximum": 2147483647,
                        "description": "Alto del paquete en milímetros; null si no está definido."
                    },
                    "sale_starts_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Cuándo empieza la oferta: compare_at_price se muestra desde ese momento; null — sin inicio."
                    },
                    "sale_ends_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Cuándo termina la oferta; null — sin fin."
                    },
                    "sold_by": {
                        "type": "string",
                        "enum": [
                            "each",
                            "weight",
                            "volume"
                        ],
                        "description": "Cómo se vende la variante: each — por unidad; weight — por peso; volume — por volumen."
                    },
                    "price_per_quantity": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 32,
                        "description": "Por cuántas unidades es el precio, como cadena decimal: una unidad, o 1000 para el precio por kilo de una variante por peso. null si una variante por peso o volumen no lo tiene definido."
                    },
                    "measure_step": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 32,
                        "description": "Paso de la cantidad en un ítem de una variante por peso o volumen, en su unidad; null si no está definido."
                    },
                    "min_measure_qty": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 32,
                        "description": "Cantidad mínima en un ítem de una variante por peso o volumen; null si no está definida."
                    },
                    "max_measure_qty": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 32,
                        "description": "Cantidad máxima en un ítem de una variante por peso o volumen; null si no está definida."
                    },
                    "net_content": {
                        "type": "object",
                        "properties": {
                            "quantity": {
                                "type": "string",
                                "maxLength": 32,
                                "description": "Medida como cadena decimal en unit: \"500\", \"0.5\"."
                            },
                            "unit": {
                                "type": "string",
                                "enum": [
                                    "g",
                                    "ml"
                                ],
                                "description": "Unidad de la medida: g — gramos; ml — mililitros."
                            }
                        },
                        "description": "Contenido neto de una unidad: paquete de 500 g, botella de 1000 ml. Un pack de varias unidades de otra variante lo toma de ella, una unidad envasada, de su propia medida; solo se puede escribir en una variante común por unidad. null en variantes por peso o volumen y en unidades sin contenido neto."
                    },
                    "barcodes": {
                        "type": [
                            "array",
                            "null"
                        ],
                        "items": {
                            "type": "object",
                            "properties": {
                                "type": {
                                    "type": "string",
                                    "enum": [
                                        "ean13",
                                        "ean8",
                                        "upca",
                                        "upce",
                                        "code128",
                                        "code39",
                                        "gtin",
                                        "itf",
                                        "qr",
                                        "datamatrix",
                                        "other"
                                    ],
                                    "description": "Simbología: ean13, ean8, upca, upce, code128, code39, gtin, itf, qr, datamatrix u other."
                                },
                                "value": {
                                    "type": "string",
                                    "description": "El código de barras."
                                },
                                "is_primary": {
                                    "type": [
                                        "boolean",
                                        "null"
                                    ],
                                    "description": "El código de barras principal de la variante: lo imprimen las etiquetas y los tickets."
                                }
                            },
                            "required": [
                                "type",
                                "value"
                            ]
                        },
                        "maxItems": 20,
                        "description": "Códigos de barras de la variante."
                    },
                    "option_values": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "option_id": {
                                    "type": "integer",
                                    "description": "ID de la opción en options del producto."
                                },
                                "value_id": {
                                    "type": "integer",
                                    "description": "ID del valor en values de esa opción."
                                }
                            },
                            "required": [
                                "option_id",
                                "value_id"
                            ]
                        },
                        "maxItems": 10,
                        "description": "Valores de opción de la variante: un valor de cada opción del producto."
                    },
                    "stock_source_variant_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "En un pack de varias unidades de otra variante: esa variante. El pack se vende de su stock y no tiene niveles de stock propios. null en una variante común."
                    },
                    "stock_source_quantity": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 32,
                        "description": "Cuánto de la variante base consume una unidad del pack, como cadena decimal en la unidad de la variante base; null en una variante común."
                    },
                    "sibling_name": {
                        "type": "object",
                        "additionalProperties": {
                            "type": [
                                "string",
                                "null"
                            ],
                            "maxLength": 255
                        },
                        "description": "Nombre por idioma de la única variante del producto, que esta solicitud convierte en una de varias: la única variante no tiene nombre propio, una de varias debe tenerlo."
                    }
                },
                "required": [
                    "product_id",
                    "price"
                ]
            },
            "CreateWebhookEndpointRequest": {
                "type": "object",
                "properties": {
                    "url": {
                        "type": "string",
                        "maxLength": 2048,
                        "description": "Dirección HTTPS a la que se envían las entregas."
                    },
                    "description": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 255,
                        "description": "Descripción del endpoint; null si no se indicó."
                    },
                    "enabled_events": {
                        "type": "array",
                        "items": {
                            "type": "string",
                            "enum": [
                                "order.created",
                                "order.updated",
                                "order.status_changed",
                                "order.paid",
                                "order.cancelled",
                                "payment.created",
                                "payment.succeeded",
                                "payment.status_changed",
                                "payment.updated",
                                "refund.created",
                                "refund.completed",
                                "refund.status_changed",
                                "refund.updated",
                                "fiscal_document.created",
                                "fiscal_document.updated",
                                "fiscal_document.issued",
                                "fiscal_document.failed",
                                "fiscal_document.annulled",
                                "tax_period.status_changed",
                                "money_transaction.created",
                                "money_transaction.updated",
                                "money_transaction.deleted",
                                "pos_shift.opened",
                                "pos_shift.closed",
                                "pos_shift.updated",
                                "pos_cash_movement.created",
                                "gift_card.created",
                                "gift_card.updated",
                                "gift_card_transaction.created",
                                "customer_account.created",
                                "customer_account.updated",
                                "customer_account_entry.created",
                                "customer_account_entry.updated",
                                "supplier.created",
                                "supplier.updated",
                                "supplier.deleted",
                                "supplier_bill.created",
                                "supplier_bill.updated",
                                "supplier_bill.posted",
                                "supplier_bill.voided",
                                "supplier_bill.deleted",
                                "supplier_bill_payment.created",
                                "supplier_bill_payment.updated",
                                "supplier_bill_payment.deleted",
                                "settlement_agreement.created",
                                "settlement_agreement.updated",
                                "settlement_agreement.deleted",
                                "settlement_offset.created",
                                "settlement_offset.updated",
                                "settlement_offset.voided",
                                "purchase_order.created",
                                "purchase_order.updated",
                                "purchase_order.status_changed",
                                "purchase_order.deleted",
                                "goods_receipt.created",
                                "goods_receipt.updated",
                                "goods_receipt.voided",
                                "supplier_return.created",
                                "supplier_return.updated",
                                "supplier_return.status_changed",
                                "supplier_return.deleted",
                                "consignment_settlement.created",
                                "consignment_settlement.updated",
                                "consignment_settlement.posted",
                                "consignment_settlement.voided",
                                "tax_withholding.created",
                                "tax_withholding.updated",
                                "tax_withholding.annulled",
                                "tax_withholding.deleted",
                                "product.created",
                                "product.updated",
                                "product.deleted",
                                "inventory_level.updated",
                                "stock_movement.created",
                                "stock_movement.updated",
                                "lot.created",
                                "lot.updated",
                                "lot.deleted",
                                "location_transfer.created",
                                "location_transfer.updated",
                                "stocktake.created",
                                "stocktake.status_changed",
                                "stocktake.updated",
                                "customer.created",
                                "customer.updated",
                                "customer.deleted",
                                "customer_group.created",
                                "customer_group.updated",
                                "customer_group.deleted",
                                "price_list.created",
                                "price_list.updated",
                                "price_list.deleted",
                                "bulk_operation.finished"
                            ]
                        },
                        "minItems": 1,
                        "maxItems": 93,
                        "uniqueItems": true,
                        "description": "Tipos de evento a los que está suscripto el endpoint, como order.created; son los tipos de GET /v1/events. Un tipo cuyo scope de lectura perdió la aplicación no se entrega."
                    }
                },
                "required": [
                    "url",
                    "enabled_events"
                ]
            },
            "Customer": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID del registro, único entre los registros de su tipo en la tienda."
                    },
                    "external_id": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "ID externo del cliente, su ID en tu sistema; null si no está definido. Después de fusionar dos clientes, el ID del fusionado también encuentra al que queda; la respuesta muestra el ID principal."
                    },
                    "version": {
                        "type": "integer",
                        "description": "Versión del registro: crece con cada cambio. Para cambiar el registro, envíela como ETag en If-Match."
                    },
                    "name": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Nombre del cliente; null si se desconoce."
                    },
                    "phone": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Teléfono principal del cliente en formato E.164, por ejemplo +5491123456789; null si se desconoce."
                    },
                    "email": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Email del cliente; null si se desconoce."
                    },
                    "language": {
                        "type": "string",
                        "enum": [
                            "ru",
                            "en",
                            "es"
                        ],
                        "description": "Idioma en el que la tienda le escribe al cliente: ru, en o es."
                    },
                    "is_blocked": {
                        "type": "boolean",
                        "description": "La tienda bloqueó al cliente: no puede ingresar a la tienda online."
                    },
                    "marketing_consents": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "channel": {
                                    "type": "string",
                                    "enum": [
                                        "email",
                                        "telegram",
                                        "whatsapp",
                                        "instagram"
                                    ],
                                    "description": "Canal de publicidad: email, telegram, whatsapp o instagram."
                                },
                                "status": {
                                    "type": "string",
                                    "enum": [
                                        "subscribed",
                                        "unsubscribed"
                                    ],
                                    "description": "subscribed — el cliente aceptó la publicidad por el canal de forma explícita; unsubscribed — la rechazó."
                                },
                                "consented_at": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "format": "date-time",
                                    "description": "Cuándo el cliente aceptó por última vez la publicidad por el canal de forma explícita; el rechazo conserva este momento. null si no la aceptó."
                                }
                            },
                            "required": [
                                "channel",
                                "status",
                                "consented_at"
                            ]
                        },
                        "description": "Consentimiento de publicidad por canal (email, telegram, whatsapp, instagram): una fila por cada canal donde el cliente aceptó (subscribed) o rechazó (unsubscribed) de forma explícita, con el momento del último consentimiento explícito. Si falta el canal, el consentimiento es implícito: una tienda con marketing_consent_mode opt_out escribe por ese canal, una con opt_in no. WhatsApp requiere subscribed."
                    },
                    "accepts_marketing": {
                        "type": "boolean",
                        "description": "Obsoleto, ver marketing_consents: el cliente no se dio de baja de la publicidad por email."
                    },
                    "marketing_consent_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Obsoleto, ver marketing_consents: cuándo el cliente aceptó la publicidad por email de forma explícita; null si no lo hizo."
                    },
                    "balance": {
                        "type": "integer",
                        "description": "Saldo del cliente en la tienda: con él se pueden pagar pedidos. En unidades mínimas de la moneda de la tienda."
                    },
                    "addresses": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "id": {
                                    "type": "integer",
                                    "description": "ID de la dirección."
                                },
                                "customer_id": {
                                    "type": "integer",
                                    "description": "ID del cliente al que pertenece la dirección."
                                },
                                "label": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "description": "Nombre de la dirección, como Casa o Trabajo; null si no se indicó."
                                },
                                "street": {
                                    "type": "string",
                                    "description": "Calle."
                                },
                                "house": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "description": "Número de la calle."
                                },
                                "apartment": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "description": "Departamento u oficina."
                                },
                                "floor": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "description": "Piso."
                                },
                                "entrance": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "description": "Entrada."
                                },
                                "district": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "description": "Barrio."
                                },
                                "postal_code": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "description": "Código postal."
                                },
                                "comment": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "description": "Comentario para el cadete, como la forma de entrar; null si no se indicó."
                                },
                                "location": {
                                    "type": [
                                        "object",
                                        "null"
                                    ],
                                    "properties": {
                                        "lat": {
                                            "type": "number",
                                            "description": "Latitud en grados."
                                        },
                                        "lng": {
                                            "type": "number",
                                            "description": "Longitud en grados."
                                        }
                                    },
                                    "required": [
                                        "lat",
                                        "lng"
                                    ],
                                    "description": "Ubicación de la dirección en el mapa; null si la dirección vino de otro sistema y aún no se ubicó."
                                },
                                "is_default": {
                                    "type": "boolean",
                                    "description": "La dirección principal del cliente. Si se elimina la principal, pasa a serlo la más reciente."
                                },
                                "created_at": {
                                    "type": "string",
                                    "format": "date-time",
                                    "description": "Cuándo se creó el registro."
                                },
                                "updated_at": {
                                    "type": "string",
                                    "format": "date-time",
                                    "description": "Cuándo cambió el registro por última vez."
                                }
                            },
                            "required": [
                                "id",
                                "customer_id",
                                "label",
                                "street",
                                "house",
                                "apartment",
                                "floor",
                                "entrance",
                                "district",
                                "postal_code",
                                "comment",
                                "location",
                                "is_default",
                                "created_at",
                                "updated_at"
                            ]
                        },
                        "description": "Libreta de direcciones del cliente; la tienda limita su tamaño. Una dirección eliminada simplemente no está en la lista."
                    },
                    "group_ids": {
                        "type": "array",
                        "items": {
                            "type": "integer"
                        },
                        "description": "Grupos del cliente por ID ascendente. La membresía la escriben los comandos del grupo: un cambio mueve al cliente en el feed y envía customer.updated, pero no cambia version ni updated_at."
                    },
                    "wholesale_price_list_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Lista de precios mayorista del cliente empresa: con ella se calculan sus ventas mayoristas. null — mayorista a precios base. La lista solo se ve con costs:read."
                    },
                    "merged_into_customer_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "El cliente en el que se fusionó este: recibió sus contactos, direcciones y pedidos. null si no se fusionó."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo se creó el registro."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo cambió el registro por última vez."
                    },
                    "deleted_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Cuándo se archivó el registro; null en un registro vigente."
                    }
                },
                "required": [
                    "id",
                    "external_id",
                    "version",
                    "name",
                    "phone",
                    "email",
                    "language",
                    "is_blocked",
                    "marketing_consents",
                    "accepts_marketing",
                    "marketing_consent_at",
                    "balance",
                    "addresses",
                    "group_ids",
                    "wholesale_price_list_id",
                    "merged_into_customer_id",
                    "created_at",
                    "updated_at",
                    "deleted_at"
                ]
            },
            "CustomerAccount": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID del registro, único entre los registros de su tipo en la tienda."
                    },
                    "status": {
                        "type": "string",
                        "enum": [
                            "active",
                            "suspended"
                        ],
                        "description": "Estado: suspended — las nuevas ventas a cuenta están cerradas; la deuda sigue y se puede cobrar. Con el otro valor el cliente compra a cuenta dentro del límite."
                    },
                    "currency": {
                        "type": "string",
                        "enum": [
                            "ARS",
                            "USD",
                            "BRL",
                            "CLP",
                            "COP",
                            "MXN",
                            "PEN",
                            "RUB"
                        ],
                        "description": "Moneda de los importes, código ISO 4217: la moneda de la tienda."
                    },
                    "balance": {
                        "type": "integer",
                        "description": "Saldo en unidades mínimas de la moneda: positivo si el cliente debe, negativo si pagó de más. Es la suma de amount de todos los movimientos de la cuenta (/v1/customer-account-entries)."
                    },
                    "credit_limit": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Límite de crédito en unidades mínimas de la moneda; null: sin límite. Por encima del límite o con deuda vencida, la venta a cuenta pide la aprobación de un encargado."
                    },
                    "payment_terms_days": {
                        "type": "integer",
                        "description": "Plazo de pago de una venta a cuenta, en días: el vencimiento del cargo (due_on) es el día de la venta más este plazo."
                    },
                    "customer_id": {
                        "type": "integer",
                        "description": "ID del cliente (/v1/customers). Solo con acceso a los clientes."
                    },
                    "note": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Nota del personal sobre el cliente; null si no hay. Solo con acceso a los clientes: se borra al eliminar al cliente."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo se creó el registro."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo cambió el registro por última vez."
                    }
                },
                "required": [
                    "id",
                    "status",
                    "currency",
                    "balance",
                    "credit_limit",
                    "payment_terms_days",
                    "created_at",
                    "updated_at"
                ]
            },
            "CustomerAccountEntry": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID del registro, único entre los registros de su tipo en la tienda."
                    },
                    "customer_account_id": {
                        "type": "integer",
                        "description": "ID de la cuenta corriente (/v1/customer-accounts). Solo cambia al unir clientes: el movimiento pasa a la cuenta del cliente que queda."
                    },
                    "kind": {
                        "type": "string",
                        "enum": [
                            "charge",
                            "opening_balance",
                            "opening_credit",
                            "payment",
                            "return",
                            "write_off",
                            "offset",
                            "withholding",
                            "reversal"
                        ],
                        "description": "Tipo de movimiento: charge — venta a cuenta; opening_balance — deuda del registro anterior; opening_credit — saldo a favor del registro anterior; payment — cobro; return — devolución de mercadería vendida a cuenta; write_off — baja de una deuda incobrable; offset — compensación con el cliente como proveedor; withholding — impuesto retenido por el cliente agente de retención al pagar; reversal — anulación del movimiento reverses_entry_id."
                    },
                    "amount": {
                        "type": "integer",
                        "description": "Importe con signo en unidades mínimas de la moneda: positivo si la deuda creció, negativo si bajó."
                    },
                    "currency": {
                        "type": "string",
                        "enum": [
                            "ARS",
                            "USD",
                            "BRL",
                            "CLP",
                            "COP",
                            "MXN",
                            "PEN",
                            "RUB"
                        ],
                        "description": "Moneda de los importes, código ISO 4217: la moneda de la tienda."
                    },
                    "legal_entity_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID de la razón social de la tienda (/v1/legal-entities) a la que se debe: un cobro cancela solo deudas de su razón social. null si no está definida."
                    },
                    "due_on": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date",
                        "description": "Vencimiento del cargo, AAAA-MM-DD en la zona horaria de la tienda: desde el día siguiente la deuda está vencida. null en los movimientos que bajan la deuda."
                    },
                    "occurred_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Momento de la operación. La deuda del registro anterior lleva fecha pasada: las operaciones se ordenan por este campo y no por el orden de carga."
                    },
                    "order_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID del pedido (/v1/orders): la venta a cuenta o el pedido de cobro con account_payment_amount; null si no hay pedido."
                    },
                    "payment_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID del pago (/v1/payments) con el medio on_account en la venta a cuenta; null en las demás entradas. El dinero de un cobro es el pago de su pedido order_id."
                    },
                    "refund_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID de la devolución (/v1/refunds) con la que volvió la mercadería vendida a cuenta; null en los demás movimientos."
                    },
                    "reverses_entry_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID del movimiento que esta anulación cancela; null en un movimiento común."
                    },
                    "settlement_offset_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID de la compensación (/v1/settlement-offsets) en un movimiento de tipo offset; null en los demás. La reversión de una compensación apunta al movimiento (reverses_entry_id)."
                    },
                    "tax_withholding_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID del certificado en el registro de retenciones (/v1/tax-withholdings, scope fiscal:read) en un movimiento de tipo withholding; null en los demás y cuando el certificado se quitó del registro: la anulación quita el certificado que creó el cobro."
                    },
                    "note": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Nota del personal: motivo de la baja, del traspaso o de la anulación; null si no hay."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo se registró el movimiento."
                    }
                },
                "required": [
                    "id",
                    "customer_account_id",
                    "kind",
                    "amount",
                    "currency",
                    "legal_entity_id",
                    "due_on",
                    "occurred_at",
                    "order_id",
                    "payment_id",
                    "refund_id",
                    "reverses_entry_id",
                    "settlement_offset_id",
                    "tax_withholding_id",
                    "note",
                    "created_at"
                ]
            },
            "CustomerAccountStatement": {
                "type": "object",
                "properties": {
                    "customer_account_id": {
                        "type": "integer",
                        "description": "ID de la cuenta corriente (/v1/customer-accounts)."
                    },
                    "currency": {
                        "type": "string",
                        "enum": [
                            "ARS",
                            "USD",
                            "BRL",
                            "CLP",
                            "COP",
                            "MXN",
                            "PEN",
                            "RUB"
                        ],
                        "description": "Moneda de los importes, código ISO 4217: la moneda de la tienda."
                    },
                    "from": {
                        "type": "string",
                        "description": "Primer día del período, AAAA-MM-DD en la zona horaria de la tienda; sin from en la consulta, el día de la primera operación de la cuenta."
                    },
                    "to": {
                        "type": "string",
                        "description": "Último día del período, AAAA-MM-DD en la zona horaria de la tienda."
                    },
                    "opening_balance": {
                        "type": "integer",
                        "description": "Deuda al inicio del período: suma de las operaciones anteriores a from."
                    },
                    "closing_balance": {
                        "type": "integer",
                        "description": "Deuda al cierre del período: opening_balance más las líneas del período."
                    },
                    "charged": {
                        "type": "integer",
                        "description": "Total de aumentos de la deuda en el período."
                    },
                    "reduced": {
                        "type": "integer",
                        "description": "Total de bajas de la deuda en el período, como número positivo."
                    },
                    "lines": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "entry_id": {
                                    "type": "integer",
                                    "description": "ID del movimiento (/v1/customer-account-entries)."
                                },
                                "kind": {
                                    "type": "string",
                                    "enum": [
                                        "charge",
                                        "opening_balance",
                                        "opening_credit",
                                        "payment",
                                        "return",
                                        "write_off",
                                        "offset",
                                        "withholding",
                                        "reversal"
                                    ],
                                    "description": "Tipo de movimiento, los mismos valores que kind de un movimiento de la cuenta."
                                },
                                "occurred_at": {
                                    "type": "string",
                                    "format": "date-time",
                                    "description": "Momento de la operación."
                                },
                                "order_id": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "ID del pedido (/v1/orders); null si no hay pedido."
                                },
                                "due_on": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "format": "date",
                                    "description": "Vencimiento del cargo; null en los movimientos que bajan la deuda."
                                },
                                "note": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "description": "Nota del personal; null si no hay."
                                },
                                "amount": {
                                    "type": "integer",
                                    "description": "Importe con signo: positivo si la deuda creció, negativo si bajó."
                                },
                                "balance": {
                                    "type": "integer",
                                    "description": "Deuda después de esta línea."
                                }
                            },
                            "required": [
                                "entry_id",
                                "kind",
                                "occurred_at",
                                "order_id",
                                "due_on",
                                "note",
                                "amount",
                                "balance"
                            ]
                        },
                        "description": "Movimientos del período en orden de operación (occurred_at) con saldo acumulado."
                    },
                    "open_items": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "entry_id": {
                                    "type": "integer",
                                    "description": "ID del cargo (/v1/customer-account-entries)."
                                },
                                "kind": {
                                    "type": "string",
                                    "enum": [
                                        "charge",
                                        "opening_balance"
                                    ],
                                    "description": "charge — venta a cuenta; opening_balance — deuda del registro anterior."
                                },
                                "occurred_at": {
                                    "type": "string",
                                    "format": "date-time",
                                    "description": "Momento de la operación."
                                },
                                "order_id": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "ID del pedido (/v1/orders); null si no hay pedido."
                                },
                                "due_on": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "format": "date",
                                    "description": "Vencimiento del cargo, AAAA-MM-DD en la zona horaria de la tienda."
                                },
                                "open_amount": {
                                    "type": "integer",
                                    "description": "Parte impaga del cargo al cierre del período."
                                },
                                "overdue": {
                                    "type": "boolean",
                                    "description": "El vencimiento pasó antes de to: al cierre del período la deuda está vencida."
                                }
                            },
                            "required": [
                                "entry_id",
                                "kind",
                                "occurred_at",
                                "order_id",
                                "due_on",
                                "open_amount",
                                "overdue"
                            ]
                        },
                        "description": "Cargos sin cancelar al cierre del período, por vencimiento. Qué cobro canceló qué cargo lo decide la imputación FIFO dentro de cada razón social."
                    }
                },
                "required": [
                    "customer_account_id",
                    "currency",
                    "from",
                    "to",
                    "opening_balance",
                    "closing_balance",
                    "charged",
                    "reduced",
                    "lines",
                    "open_items"
                ]
            },
            "CustomerAddress": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID de la dirección."
                    },
                    "customer_id": {
                        "type": "integer",
                        "description": "ID del cliente al que pertenece la dirección."
                    },
                    "label": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Nombre de la dirección, como Casa o Trabajo; null si no se indicó."
                    },
                    "street": {
                        "type": "string",
                        "description": "Calle."
                    },
                    "house": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Número de la calle."
                    },
                    "apartment": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Departamento u oficina."
                    },
                    "floor": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Piso."
                    },
                    "entrance": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Entrada."
                    },
                    "district": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Barrio."
                    },
                    "postal_code": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Código postal."
                    },
                    "comment": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Comentario para el cadete, como la forma de entrar; null si no se indicó."
                    },
                    "location": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "properties": {
                            "lat": {
                                "type": "number",
                                "description": "Latitud en grados."
                            },
                            "lng": {
                                "type": "number",
                                "description": "Longitud en grados."
                            }
                        },
                        "required": [
                            "lat",
                            "lng"
                        ],
                        "description": "Ubicación de la dirección en el mapa; null si la dirección vino de otro sistema y aún no se ubicó."
                    },
                    "is_default": {
                        "type": "boolean",
                        "description": "La dirección principal del cliente. Si se elimina la principal, pasa a serlo la más reciente."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo se creó el registro."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo cambió el registro por última vez."
                    }
                },
                "required": [
                    "id",
                    "customer_id",
                    "label",
                    "street",
                    "house",
                    "apartment",
                    "floor",
                    "entrance",
                    "district",
                    "postal_code",
                    "comment",
                    "location",
                    "is_default",
                    "created_at",
                    "updated_at"
                ]
            },
            "CustomerFiscalProfile": {
                "type": "object",
                "properties": {
                    "customer_id": {
                        "type": "integer",
                        "description": "ID del cliente."
                    },
                    "receptor": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "properties": {
                            "id_type": {
                                "type": "string",
                                "enum": [
                                    "tax_id",
                                    "personal_id",
                                    "national_id",
                                    "passport",
                                    "none"
                                ],
                                "description": "Tipo de identificación: tax_id — CUIT de una empresa; personal_id — CUIL de una persona; national_id — DNI; passport — pasaporte; none — sin identificación."
                            },
                            "id_number": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "description": "Número de la identificación; null cuando id_type es none."
                            },
                            "name": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "description": "Razón social o nombre completo para el comprobante; null si no se indicó."
                            },
                            "tax_status": {
                                "type": "string",
                                "enum": [
                                    "registered",
                                    "small_taxpayer",
                                    "exempt",
                                    "final_consumer",
                                    "not_categorized",
                                    "foreign"
                                ],
                                "description": "Condición frente al IVA: registered — Responsable Inscripto; small_taxpayer — Monotributo; exempt — exento; final_consumer — consumidor final; not_categorized — no categorizado; foreign — cliente del exterior."
                            },
                            "address": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "description": "Domicilio fiscal en una línea; null si no se indicó."
                            }
                        },
                        "required": [
                            "id_type",
                            "id_number",
                            "name",
                            "tax_status",
                            "address"
                        ],
                        "description": "Datos fiscales con los que se emiten los comprobantes de los pedidos nuevos; null — un cliente minorista sin datos fiscales. Un pedido ya confirmado guarda su propia copia (fiscal_receptor del pedido)."
                    }
                },
                "required": [
                    "customer_id",
                    "receptor"
                ]
            },
            "CustomerGroup": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID del registro, único entre los registros de su tipo en la tienda."
                    },
                    "version": {
                        "type": "integer",
                        "description": "Versión del registro: crece con cada cambio. Para cambiar el registro, envíela como ETag en If-Match."
                    },
                    "name": {
                        "type": "string",
                        "description": "Nombre del grupo: una etiqueta de la tienda, el cliente no la ve. Único en la tienda sin distinguir mayúsculas."
                    },
                    "description": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Descripción para el personal; null si no está definida."
                    },
                    "is_active": {
                        "type": "boolean",
                        "description": "Si el grupo está activo. Un grupo inactivo no selecciona a nadie: los descuentos y los envíos no ven a sus miembros, y la membresía se conserva."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo se creó el registro."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo cambió el registro por última vez."
                    }
                },
                "required": [
                    "id",
                    "version",
                    "name",
                    "description",
                    "is_active",
                    "created_at",
                    "updated_at"
                ]
            },
            "DeliveryMethod": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID del registro, único entre los registros de su tipo en la tienda."
                    },
                    "code": {
                        "type": "string",
                        "description": "Código del registro, único en la tienda: no cambia al renombrar el registro."
                    },
                    "name": {
                        "type": "object",
                        "additionalProperties": {
                            "type": "string"
                        },
                        "description": "Nombre del método de envío por idioma."
                    },
                    "fulfilment_type": {
                        "type": "string",
                        "enum": [
                            "self_pickup",
                            "home_delivery",
                            "parcel_locker",
                            "mail_post",
                            "pos",
                            "aggregator",
                            "manual_courier"
                        ],
                        "description": "Cómo entrega el método, los mismos valores que fulfilment_type de un pedido."
                    },
                    "is_active": {
                        "type": "boolean",
                        "description": "false — los clientes no pueden elegir el método."
                    },
                    "position": {
                        "type": "integer",
                        "description": "Posición en el orden: la menor va primero."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo se creó el registro."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo cambió el registro por última vez."
                    },
                    "deleted_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Cuándo se archivó el registro; null en un registro vigente."
                    }
                },
                "required": [
                    "id",
                    "code",
                    "name",
                    "fulfilment_type",
                    "is_active",
                    "position",
                    "created_at",
                    "updated_at",
                    "deleted_at"
                ]
            },
            "DiscountRoundingMode": {
                "type": "string",
                "enum": [
                    "nearest",
                    "up",
                    "down"
                ]
            },
            "DismissFiscalDocumentRequest": {
                "type": "object",
                "properties": {
                    "reason": {
                        "type": "string",
                        "minLength": 3,
                        "maxLength": 500,
                        "description": "Por qué no se va a emitir el comprobante, con tus palabras, de 3 a 500 caracteres: lo va a pedir una auditoría fiscal."
                    }
                },
                "required": [
                    "reason"
                ]
            },
            "DraftOrder": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID del registro, único entre los registros de su tipo en la tienda."
                    },
                    "version": {
                        "type": "integer",
                        "description": "Revisión del borrador: cualquier cambio la mueve, también uno del personal en el panel. Bajo ella el borrador se cambia, se elimina y se confirma."
                    },
                    "status": {
                        "type": "string",
                        "enum": [
                            "open",
                            "completed",
                            "cancelled"
                        ],
                        "description": "open — se puede cambiar y confirmar; completed — confirmado, el pedido está en order_id; cancelled — cancelado sin pedido."
                    },
                    "customer_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "El cliente del borrador (/v1/customers); null hasta elegirlo."
                    },
                    "order_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "El pedido confirmado desde el borrador; null hasta confirmarlo."
                    },
                    "lines": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "id": {
                                    "type": "integer",
                                    "description": "ID de la línea en el borrador."
                                },
                                "variant_id": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "Variante de la línea; null en una línea libre."
                                },
                                "product_id": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "Producto de la línea; null en una línea libre."
                                },
                                "product_name": {
                                    "type": "object",
                                    "additionalProperties": {
                                        "type": "string"
                                    },
                                    "description": "Nombre del producto al momento de la venta, por idioma."
                                },
                                "variant_name": {
                                    "type": "object",
                                    "additionalProperties": {
                                        "type": "string"
                                    },
                                    "description": "Nombre de la variante al momento de la venta, por idioma; un objeto vacío si la variante no tenía nombre."
                                },
                                "custom_name": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "description": "Nombre de una línea libre que el personal agregó sin producto; null en una línea con variante."
                                },
                                "quantity": {
                                    "type": "string",
                                    "description": "Cantidad como cadena decimal en unit: unidades en un ítem por unidad, la medida en un ítem por peso o volumen (\"480\" gramos)."
                                },
                                "unit": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "enum": [
                                        "pcs",
                                        "g",
                                        "ml",
                                        null
                                    ],
                                    "description": "Unidad de quantity: pcs, g o ml; null si la variante ya no conoce la unidad de su medida."
                                },
                                "unit_price": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "Precio de una unidad con sus adicionales; null en un borrador cerrado."
                                },
                                "discount": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "Rebaja de la línea; null en un borrador cerrado."
                                },
                                "total": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "Importe de la línea antes de la rebaja; null en un borrador cerrado."
                                },
                                "modifiers": {
                                    "type": "array",
                                    "items": {
                                        "type": "object",
                                        "properties": {
                                            "option_id": {
                                                "type": "integer",
                                                "description": "ID de la opción del adicional."
                                            },
                                            "quantity": {
                                                "type": "integer",
                                                "description": "Cuántas veces se agrega el adicional."
                                            }
                                        },
                                        "required": [
                                            "option_id",
                                            "quantity"
                                        ]
                                    },
                                    "description": "Adicionales de la línea, como los toppings de un plato."
                                }
                            },
                            "required": [
                                "id",
                                "variant_id",
                                "product_id",
                                "product_name",
                                "variant_name",
                                "custom_name",
                                "quantity",
                                "unit",
                                "unit_price",
                                "discount",
                                "total",
                                "modifiers"
                            ]
                        },
                        "description": "Ítems del borrador. Un borrador abierto se calcula en vivo según el catálogo, los descuentos y el envío; uno cerrado guarda sus ítems sin precios."
                    },
                    "delivery_method_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Método de envío (/v1/delivery-methods); null hasta elegirlo."
                    },
                    "address_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Dirección de la libreta del cliente, para un método con envío; null hasta elegirla."
                    },
                    "pickup_location_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Punto de retiro para un método de retiro. Un método con un solo punto lo usa por su cuenta; con varios, el borrador debe nombrar uno."
                    },
                    "delivery_slots": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "from": {
                                    "type": "string",
                                    "description": "Inicio de la franja."
                                },
                                "to": {
                                    "type": "string",
                                    "description": "Fin de la franja."
                                }
                            },
                            "required": [
                                "from",
                                "to"
                            ]
                        },
                        "description": "Franjas de entrega elegidas para un método que trabaja con franjas."
                    },
                    "delivery_cost_override": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Precio de envío fijado a mano en lugar del cálculo del método; null — según las reglas del método."
                    },
                    "payment_method": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "enum": [
                            "cash",
                            "mercadopago",
                            "crypto",
                            "bybit",
                            "trc20",
                            "balance",
                            "modo",
                            "payway",
                            "mercadopago_qr",
                            "mercadopago_point",
                            "mercadopago_transfer",
                            "gift_card",
                            "subscription",
                            "deposit",
                            "external",
                            "manual",
                            "offset",
                            "on_account",
                            "exchange_credit",
                            "bonpunto",
                            "service_package",
                            null
                        ],
                        "description": "Medio de pago con el que se confirmará el borrador: de él dependen los descuentos por medio de pago y la compatibilidad con el envío."
                    },
                    "manual_payment_method_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Medio de pago manual de la tienda cuando payment_method es manual; si no, null."
                    },
                    "promocode": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Cupón aplicado al borrador; null si no hay."
                    },
                    "customer_comment": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Comentario del cliente al pedido. Solo con el scope customers:read."
                    },
                    "note": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Nota interna de la tienda: pasa al pedido, el cliente no la ve."
                    },
                    "currency": {
                        "type": "string",
                        "description": "Moneda de los importes, código ISO 4217: la moneda de la tienda."
                    },
                    "items_total": {
                        "type": "integer",
                        "description": "Suma de las líneas antes del descuento del pedido."
                    },
                    "discount": {
                        "type": "integer",
                        "description": "Descuento del pedido."
                    },
                    "delivery_cost": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Envío a pagar; null si todavía no se puede calcular."
                    },
                    "total": {
                        "type": "integer",
                        "description": "Importe a pagar."
                    },
                    "issues": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "code": {
                                    "type": "string",
                                    "enum": [
                                        "customer_required",
                                        "phone_required",
                                        "items_empty",
                                        "import_lines_pending",
                                        "import_parse_running",
                                        "items_unavailable",
                                        "modifier_invalid",
                                        "price_missing",
                                        "measure_required",
                                        "insufficient_stock",
                                        "presale_not_ready",
                                        "presale_plan_short",
                                        "gift_card_sales_disabled",
                                        "delivery_method_required",
                                        "address_required",
                                        "branch_required",
                                        "pickup_location_required",
                                        "pickup_location_none",
                                        "pickup_location_mismatch",
                                        "slot_required",
                                        "slot_invalid",
                                        "delivery_not_applicable",
                                        "delivery_cost_required",
                                        "promocode_invalid",
                                        "payment_delivery_incompatible"
                                    ],
                                    "description": "customer_required — sin cliente; phone_required — el cliente no tiene teléfono; items_empty — sin líneas; import_lines_pending, import_parse_running — las líneas importadas aún no están listas; items_unavailable — un producto no está a la venta; modifier_invalid — un adicional no corresponde al ítem; price_missing — un producto no tiene precio; measure_required — un ítem por peso o volumen necesita su medida; insufficient_stock — no alcanza el stock; presale_not_ready, presale_plan_short — un producto en preventa no está listo o le quedan menos que lo pedido; gift_card_sales_disabled — la tienda no vende tarjetas de regalo; delivery_method_required — sin método de envío; address_required — el envío necesita una dirección; branch_required — el método necesita una sucursal del transportista; pickup_location_required — el método tiene varios puntos de retiro, nombre uno; pickup_location_none — el método no tiene un punto disponible; pickup_location_mismatch — el método no atiende ese punto; slot_required — el método necesita una franja de entrega; slot_invalid — la franja no está disponible; delivery_not_applicable — el método no entrega este pedido; delivery_cost_required — el método necesita un precio de envío a mano; promocode_invalid — el cupón no aplica; payment_delivery_incompatible — el medio de pago no funciona con ese método de envío."
                                },
                                "line_id": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "La línea a la que se refiere el problema; null en un problema de todo el borrador."
                                }
                            },
                            "required": [
                                "code",
                                "line_id"
                            ]
                        },
                        "description": "Lo que impide confirmar el borrador; vacío si nada lo impide y en un borrador cerrado."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo se creó el registro."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo cambió el registro por última vez."
                    }
                },
                "required": [
                    "id",
                    "version",
                    "status",
                    "customer_id",
                    "order_id",
                    "lines",
                    "delivery_method_id",
                    "address_id",
                    "pickup_location_id",
                    "delivery_slots",
                    "delivery_cost_override",
                    "payment_method",
                    "manual_payment_method_id",
                    "promocode",
                    "note",
                    "currency",
                    "items_total",
                    "discount",
                    "delivery_cost",
                    "total",
                    "issues",
                    "created_at",
                    "updated_at"
                ]
            },
            "Event": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID del evento; las entregas lo envían como webhook-id. Los eventos se guardan 30 días."
                    },
                    "type": {
                        "type": "string",
                        "enum": [
                            "order.created",
                            "order.updated",
                            "order.status_changed",
                            "order.paid",
                            "order.cancelled",
                            "payment.created",
                            "payment.succeeded",
                            "payment.status_changed",
                            "payment.updated",
                            "refund.created",
                            "refund.completed",
                            "refund.status_changed",
                            "refund.updated",
                            "fiscal_document.created",
                            "fiscal_document.updated",
                            "fiscal_document.issued",
                            "fiscal_document.failed",
                            "fiscal_document.annulled",
                            "tax_period.status_changed",
                            "money_transaction.created",
                            "money_transaction.updated",
                            "money_transaction.deleted",
                            "pos_shift.opened",
                            "pos_shift.closed",
                            "pos_shift.updated",
                            "pos_cash_movement.created",
                            "gift_card.created",
                            "gift_card.updated",
                            "gift_card_transaction.created",
                            "customer_account.created",
                            "customer_account.updated",
                            "customer_account_entry.created",
                            "customer_account_entry.updated",
                            "supplier.created",
                            "supplier.updated",
                            "supplier.deleted",
                            "supplier_bill.created",
                            "supplier_bill.updated",
                            "supplier_bill.posted",
                            "supplier_bill.voided",
                            "supplier_bill.deleted",
                            "supplier_bill_payment.created",
                            "supplier_bill_payment.updated",
                            "supplier_bill_payment.deleted",
                            "settlement_agreement.created",
                            "settlement_agreement.updated",
                            "settlement_agreement.deleted",
                            "settlement_offset.created",
                            "settlement_offset.updated",
                            "settlement_offset.voided",
                            "purchase_order.created",
                            "purchase_order.updated",
                            "purchase_order.status_changed",
                            "purchase_order.deleted",
                            "goods_receipt.created",
                            "goods_receipt.updated",
                            "goods_receipt.voided",
                            "supplier_return.created",
                            "supplier_return.updated",
                            "supplier_return.status_changed",
                            "supplier_return.deleted",
                            "consignment_settlement.created",
                            "consignment_settlement.updated",
                            "consignment_settlement.posted",
                            "consignment_settlement.voided",
                            "tax_withholding.created",
                            "tax_withholding.updated",
                            "tax_withholding.annulled",
                            "tax_withholding.deleted",
                            "product.created",
                            "product.updated",
                            "product.deleted",
                            "inventory_level.updated",
                            "stock_movement.created",
                            "stock_movement.updated",
                            "lot.created",
                            "lot.updated",
                            "lot.deleted",
                            "location_transfer.created",
                            "location_transfer.updated",
                            "stocktake.created",
                            "stocktake.status_changed",
                            "stocktake.updated",
                            "customer.created",
                            "customer.updated",
                            "customer.deleted",
                            "customer_group.created",
                            "customer_group.updated",
                            "customer_group.deleted",
                            "price_list.created",
                            "price_list.updated",
                            "price_list.deleted",
                            "bulk_operation.finished"
                        ],
                        "description": "Tipo de evento: order.created, order.updated, order.status_changed, order.paid, order.cancelled; payment.created, payment.succeeded, payment.status_changed, payment.updated; refund.created, refund.completed, refund.status_changed, refund.updated; product.created, product.updated, product.deleted; inventory_level.updated; customer.created, customer.updated, customer.deleted; fiscal_document.created, fiscal_document.updated, fiscal_document.issued, fiscal_document.failed, fiscal_document.annulled; tax_period.status_changed; bulk_operation.finished."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo ocurrió el cambio."
                    },
                    "actor": {
                        "type": "object",
                        "properties": {
                            "type": {
                                "type": "string",
                                "enum": [
                                    "integration_app",
                                    "operator",
                                    "customer",
                                    "courier",
                                    "device",
                                    "supplier",
                                    "system"
                                ],
                                "description": "integration_app — una aplicación (actor.id es su id de /v1/me); operator — un miembro del personal; customer — un cliente; courier — un cadete; device — una caja u otro dispositivo de la tienda; supplier — un proveedor; system — un proceso automático."
                            },
                            "id": {
                                "type": [
                                    "integer",
                                    "null"
                                ],
                                "description": "ID del autor entre los de su tipo; null en system."
                            }
                        },
                        "required": [
                            "type",
                            "id"
                        ],
                        "description": "Quién hizo el cambio."
                    },
                    "request_id": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "ID de la solicitud de esta aplicación que hizo el cambio (X-Request-Id): con él la aplicación reconoce sus propios cambios. null si el cambio no lo hizo ella."
                    },
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "integer",
                                "description": "ID del registro."
                            },
                            "object": {
                                "anyOf": [
                                    {
                                        "$ref": "#/components/schemas/Order"
                                    },
                                    {
                                        "$ref": "#/components/schemas/Payment"
                                    },
                                    {
                                        "$ref": "#/components/schemas/Refund"
                                    },
                                    {
                                        "$ref": "#/components/schemas/FiscalDocument"
                                    },
                                    {
                                        "$ref": "#/components/schemas/TaxPeriod"
                                    },
                                    {
                                        "$ref": "#/components/schemas/TaxWithholding"
                                    },
                                    {
                                        "$ref": "#/components/schemas/MoneyTransaction"
                                    },
                                    {
                                        "$ref": "#/components/schemas/PosShift"
                                    },
                                    {
                                        "$ref": "#/components/schemas/PosCashMovement"
                                    },
                                    {
                                        "$ref": "#/components/schemas/GiftCard"
                                    },
                                    {
                                        "$ref": "#/components/schemas/GiftCardTransaction"
                                    },
                                    {
                                        "$ref": "#/components/schemas/CustomerAccount"
                                    },
                                    {
                                        "$ref": "#/components/schemas/CustomerAccountEntry"
                                    },
                                    {
                                        "$ref": "#/components/schemas/Supplier"
                                    },
                                    {
                                        "$ref": "#/components/schemas/SupplierBill"
                                    },
                                    {
                                        "$ref": "#/components/schemas/SupplierBillPayment"
                                    },
                                    {
                                        "$ref": "#/components/schemas/SettlementAgreement"
                                    },
                                    {
                                        "$ref": "#/components/schemas/SettlementOffset"
                                    },
                                    {
                                        "$ref": "#/components/schemas/PurchaseOrder"
                                    },
                                    {
                                        "$ref": "#/components/schemas/GoodsReceipt"
                                    },
                                    {
                                        "$ref": "#/components/schemas/SupplierReturn"
                                    },
                                    {
                                        "$ref": "#/components/schemas/ConsignmentSettlement"
                                    },
                                    {
                                        "$ref": "#/components/schemas/Product"
                                    },
                                    {
                                        "$ref": "#/components/schemas/InventoryLevel"
                                    },
                                    {
                                        "$ref": "#/components/schemas/StockMovement"
                                    },
                                    {
                                        "$ref": "#/components/schemas/Lot"
                                    },
                                    {
                                        "$ref": "#/components/schemas/LocationTransfer"
                                    },
                                    {
                                        "$ref": "#/components/schemas/Stocktake"
                                    },
                                    {
                                        "$ref": "#/components/schemas/Customer"
                                    },
                                    {
                                        "$ref": "#/components/schemas/CustomerGroup"
                                    },
                                    {
                                        "$ref": "#/components/schemas/PriceList"
                                    },
                                    {
                                        "$ref": "#/components/schemas/BulkOperation"
                                    },
                                    {
                                        "type": "null"
                                    }
                                ],
                                "x-open-variants": true,
                                "description": "El registro tal como está ahora: el mismo objeto que devuelve su endpoint de /v1, con los campos según los scopes de la aplicación. null si el registro ya no existe. Los eventos pueden llegar desordenados: version del objeto indica cuál es más reciente."
                            },
                            "previous_attributes": {
                                "type": [
                                    "object",
                                    "null"
                                ],
                                "properties": {
                                    "status": {
                                        "type": "string",
                                        "description": "Estado anterior: del pedido en order.status_changed, del período fiscal en tax_period.status_changed, del comprobante en fiscal_document.failed."
                                    }
                                },
                                "required": [
                                    "status"
                                ],
                                "description": "Valores anteriores de los campos de los que trata el evento; null si no hay."
                            }
                        },
                        "required": [
                            "id",
                            "object",
                            "previous_attributes"
                        ],
                        "description": "De qué trata el evento."
                    }
                },
                "required": [
                    "id",
                    "type",
                    "created_at",
                    "actor",
                    "request_id",
                    "data"
                ]
            },
            "ExchangeRate": {
                "type": "object",
                "properties": {
                    "currency": {
                        "type": "string",
                        "description": "Moneda de la cotización — código ISO 4217 o de activo (USDT): 1 unidad de esta moneda = rate unidades de la moneda de la tienda."
                    },
                    "store_currency": {
                        "type": "string",
                        "description": "Moneda de la tienda, código ISO 4217."
                    },
                    "date": {
                        "type": "string",
                        "description": "Fecha contable pedida, AAAA-MM-DD en la zona horaria de la tienda."
                    },
                    "rate": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Cotización contable del día como cadena decimal: 1 currency = rate de la moneda de la tienda — con ella el libro de dinero convierte los movimientos de una cuenta en esta moneda en esta fecha. null — la cotización del día todavía no se fijó (la fija la primera operación en moneda extranjera del día) o ninguna fuente cotiza el par. \"1\" para la moneda de la tienda."
                    },
                    "rate_date": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Día en que se fijó la cotización: para una fecha sin cotización propia el libro toma la anterior más cercana; para una fecha previa a la primera fijación, la primera. null — no hay cotización."
                    },
                    "source": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "enum": [
                            "coingecko",
                            "criptoya_p2p",
                            "ar_oficial",
                            "ar_blue",
                            "ar_mep",
                            "ar_ccl",
                            "ar_mayorista",
                            "cbr",
                            null
                        ],
                        "description": "Fuente de cotización de mercado de la regla de la tienda: coingecko, criptoya_p2p, ar_oficial, ar_blue, ar_mep, ar_ccl, ar_mayorista, cbr. null — ninguna fuente cotiza el par (la tienda lo acepta solo con cotización manual) o es la moneda de la tienda."
                    }
                },
                "required": [
                    "currency",
                    "store_currency",
                    "date",
                    "rate",
                    "rate_date",
                    "source"
                ]
            },
            "FiscalDocument": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID del registro, único entre los registros de su tipo en la tienda."
                    },
                    "type": {
                        "type": "string",
                        "enum": [
                            "invoice",
                            "credit_note",
                            "debit_note"
                        ],
                        "description": "invoice — factura de venta; credit_note — nota de crédito: devolución, reducción del pedido o anulación de la factura; debit_note — nota de débito: aumento del pedido después de la factura."
                    },
                    "status": {
                        "type": "string",
                        "enum": [
                            "pending",
                            "issued",
                            "rejected",
                            "failed",
                            "voided"
                        ],
                        "description": "issued — autorizado por el fisco; pending — espera emisión; failed — falló la emisión y se reintenta sola; rejected — rechazado por el fisco, hay que corregir datos; voided — emisión cancelada junto con la venta, sin rastro legal."
                    },
                    "status_reason": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "additionalProperties": {
                            "type": "string"
                        },
                        "description": "Por qué el comprobante está en este estado (rechazo del fisco, falla o cancelación) en los idiomas de la tienda; null en los emitidos y pendientes."
                    },
                    "legal_entity_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID de la razón social emisora; null — comprobante anterior a la división de ventas por razón social: su emisor es la razón social predeterminada."
                    },
                    "order_id": {
                        "type": "integer",
                        "description": "ID del pedido."
                    },
                    "refund_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID de la devolución que documenta la nota de crédito; null en los demás comprobantes."
                    },
                    "related_document_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID de la factura que corrige la nota; null en una factura."
                    },
                    "number": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Número tal como figura impreso, por ejemplo 0004-00000013; null hasta que se emite."
                    },
                    "issued_on": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date",
                        "description": "Fecha contable del comprobante, YYYY-MM-DD en la zona horaria de la tienda: define su período fiscal. null hasta que se emite."
                    },
                    "issued_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Cuándo el fisco autorizó el comprobante; null hasta que se emite."
                    },
                    "currency": {
                        "type": "string",
                        "description": "Moneda de los importes, código ISO 4217: la moneda de la tienda."
                    },
                    "total": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Importe del comprobante con impuestos; null en comprobantes creados antes de que la tienda guardara el importe."
                    },
                    "tax_lines": {
                        "type": [
                            "array",
                            "null"
                        ],
                        "items": {
                            "$ref": "#/components/schemas/TaxLine"
                        },
                        "description": "Impuestos autorizados por el fisco, los que valen legalmente: los define la condición de la razón social emisora y pueden diferir de los del pedido. null si el comprobante no está emitido, no discrimina impuestos (factura C de monotributista) o el desglose no se puede reconstruir."
                    },
                    "annulment": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "properties": {
                            "annulled_at": {
                                "type": "string",
                                "format": "date-time",
                                "description": "Cuándo se anuló la factura."
                            },
                            "document_id": {
                                "type": [
                                    "integer",
                                    "null"
                                ],
                                "description": "ID de la nota de crédito de anulación."
                            },
                            "reason": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "enum": [
                                    "order_cancelled",
                                    "advance_applied",
                                    "manual",
                                    null
                                ],
                                "description": "Por qué se anuló: order_cancelled — se canceló la venta; advance_applied — la seña de la reserva se aplicó al ticket y la factura del ticket la documenta; manual — decisión de una persona o una app, el motivo en palabras está en comment. null si no se encuentra la nota de anulación."
                            },
                            "comment": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "description": "El motivo en palabras de quien anuló la factura, en manual; null si la anuló el sistema."
                            }
                        },
                        "required": [
                            "annulled_at",
                            "document_id",
                            "reason",
                            "comment"
                        ],
                        "description": "La factura fue anulada con una nota: sigue en el fisco pero ya no vale para la venta. null si no fue anulada."
                    },
                    "dismissal": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "properties": {
                            "dismissed_at": {
                                "type": "string",
                                "format": "date-time",
                                "description": "Cuándo se sacó de control el comprobante."
                            },
                            "reason": {
                                "type": "string",
                                "description": "El motivo en palabras de quien lo sacó de control."
                            }
                        },
                        "required": [
                            "dismissed_at",
                            "reason"
                        ],
                        "description": "El comprobante está fuera de control: el fisco lo rechazó (o no aceptó su informe CAEA) y no se va a emitir. El estado del comprobante no cambia. null si no se sacó de control."
                    },
                    "receptor": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "properties": {
                            "id_type": {
                                "type": "string",
                                "enum": [
                                    "tax_id",
                                    "personal_id",
                                    "national_id",
                                    "passport",
                                    "none"
                                ],
                                "description": "Tipo de identificación: tax_id — CUIT de una empresa; personal_id — CUIL de una persona; national_id — DNI; passport — pasaporte; none — sin identificación."
                            },
                            "id_number": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "description": "Número de la identificación; null cuando id_type es none."
                            },
                            "name": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "description": "Razón social o nombre completo para el comprobante; null si no se indicó."
                            },
                            "tax_status": {
                                "type": "string",
                                "enum": [
                                    "registered",
                                    "small_taxpayer",
                                    "exempt",
                                    "final_consumer",
                                    "not_categorized",
                                    "foreign"
                                ],
                                "description": "Condición frente al IVA: registered — Responsable Inscripto; small_taxpayer — Monotributo; exempt — exento; final_consumer — consumidor final; not_categorized — no categorizado; foreign — cliente del exterior."
                            },
                            "address": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "description": "Domicilio fiscal en una línea; null si no se indicó."
                            }
                        },
                        "required": [
                            "id_type",
                            "id_number",
                            "name",
                            "tax_status",
                            "address"
                        ],
                        "description": "A quién se emitió el comprobante; null en una venta minorista sin datos fiscales. Solo con el scope customers:read."
                    },
                    "ar": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "properties": {
                            "document_type_code": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "description": "Código de tipo de comprobante de ARCA: 001 — factura A, 006 — factura B, 011 — factura C; 003, 008, 013 — notas de crédito A, B, C."
                            },
                            "point_of_sale": {
                                "type": [
                                    "integer",
                                    "null"
                                ],
                                "description": "Punto de venta."
                            },
                            "sequence_number": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "description": "Número correlativo del comprobante en el punto de venta, 8 dígitos."
                            },
                            "authorization_kind": {
                                "type": "string",
                                "enum": [
                                    "CAE",
                                    "CAEA"
                                ],
                                "description": "CAE — código otorgado al emitir en línea; CAEA — código otorgado por anticipado, emisión en contingencia."
                            },
                            "authorization_code": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "description": "Código de autorización: CAE o CAEA."
                            },
                            "authorization_expires_on": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "format": "date",
                                "description": "Vencimiento del código de autorización, YYYY-MM-DD; null si se desconoce."
                            },
                            "testing": {
                                "type": "boolean",
                                "description": "true — emitido en el entorno de homologación de ARCA: no tiene validez legal y no se debe registrar como venta."
                            }
                        },
                        "required": [
                            "document_type_code",
                            "point_of_sale",
                            "sequence_number",
                            "authorization_kind",
                            "authorization_code",
                            "authorization_expires_on",
                            "testing"
                        ],
                        "description": "Datos de ARCA; null en una tienda de otro país, en un comprobante sin emitir y cuando no se pueden reconstruir con lo que guardó el proveedor."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo se creó el registro."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo cambió el registro por última vez."
                    }
                },
                "required": [
                    "id",
                    "type",
                    "status",
                    "status_reason",
                    "legal_entity_id",
                    "order_id",
                    "refund_id",
                    "related_document_id",
                    "number",
                    "issued_on",
                    "issued_at",
                    "currency",
                    "total",
                    "tax_lines",
                    "annulment",
                    "dismissal",
                    "ar",
                    "created_at",
                    "updated_at"
                ]
            },
            "ForbiddenProblem": {
                "type": "object",
                "properties": {
                    "type": {
                        "type": "string",
                        "description": "Tipo técnico del problema: un código estable para decidir qué hacer, como insufficient_scope. Cada tipo tiene una página en el catálogo de errores."
                    },
                    "title": {
                        "type": "string",
                        "description": "Resumen breve del problema en el idioma de la solicitud."
                    },
                    "status": {
                        "type": "integer",
                        "description": "Estado HTTP de la respuesta."
                    },
                    "detail": {
                        "type": "string",
                        "description": "Explicación de este caso en el idioma de la solicitud."
                    },
                    "required_scope": {
                        "type": "string",
                        "description": "En insufficient_scope — el scope que necesita el endpoint."
                    },
                    "accepted_scopes": {
                        "type": "array",
                        "items": {
                            "type": "string"
                        },
                        "description": "En insufficient_scope — los scopes que acepta el endpoint: alcanza con cualquiera. En un endpoint con un solo scope, solo ese."
                    }
                },
                "required": [
                    "type",
                    "title",
                    "status"
                ]
            },
            "GiftCard": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID del registro, único entre los registros de su tipo en la tienda."
                    },
                    "last4": {
                        "type": "string",
                        "description": "Los últimos cuatro caracteres del código de la tarjeta: con ellos se la reconoce en manos del cliente. El código no se guarda."
                    },
                    "status": {
                        "type": "string",
                        "enum": [
                            "active",
                            "pending_payment",
                            "disabled",
                            "deactivated"
                        ],
                        "description": "Estado: pending_payment — vendida con un medio que no es efectivo, pago aún sin confirmar; disabled — bloqueada (perdida, disputa), la deuda se mantiene; deactivated — anulada, saldo cancelado. Con el cuarto valor la tarjeta está vigente: se acepta como pago si le queda saldo y no venció."
                    },
                    "currency": {
                        "type": "string",
                        "enum": [
                            "ARS",
                            "USD",
                            "BRL",
                            "CLP",
                            "COP",
                            "MXN",
                            "PEN",
                            "RUB"
                        ],
                        "description": "Moneda de los importes, código ISO 4217: la moneda de la tienda."
                    },
                    "initial_amount": {
                        "type": "integer",
                        "description": "Valor nominal al emitirla, en unidades mínimas de la moneda."
                    },
                    "balance": {
                        "type": "integer",
                        "description": "Saldo de la tarjeta en unidades mínimas de la moneda: la suma de sus movimientos (/v1/gift-card-transactions)."
                    },
                    "outstanding": {
                        "type": "integer",
                        "description": "La deuda de la tienda por la tarjeta: el saldo, salvo en una tarjeta sin pagar (pending_payment), por la que no entró dinero. Una tarjeta bloqueada o vencida mantiene su deuda."
                    },
                    "expires_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Fin de la vigencia; null si no vence. Una tarjeta vencida no se acepta como pago."
                    },
                    "issued_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo se emitió la tarjeta."
                    },
                    "issued_order_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID del pedido (/v1/orders) con el que se vendió la tarjeta; null si se emitió sin venta (compensación, promo)."
                    },
                    "reissued_from_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID de la tarjeta cuyo saldo se traspasó acá al reemitirla; null en una emisión común."
                    },
                    "customer_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID del cliente titular (/v1/customers); null si es al portador. Solo con acceso a clientes."
                    },
                    "note": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Nota del personal al emitirla; null si no hay."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo se creó el registro."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo cambió el registro por última vez."
                    }
                },
                "required": [
                    "id",
                    "last4",
                    "status",
                    "currency",
                    "initial_amount",
                    "balance",
                    "outstanding",
                    "expires_at",
                    "issued_at",
                    "issued_order_id",
                    "reissued_from_id",
                    "note",
                    "created_at",
                    "updated_at"
                ]
            },
            "GiftCardTransaction": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID del registro, único entre los registros de su tipo en la tienda."
                    },
                    "gift_card_id": {
                        "type": "integer",
                        "description": "ID de la tarjeta de regalo (/v1/gift-cards)."
                    },
                    "type": {
                        "type": "string",
                        "enum": [
                            "issue",
                            "redeem",
                            "refund",
                            "adjust",
                            "void",
                            "block",
                            "unblock",
                            "transfer_out",
                            "transfer_in"
                        ],
                        "description": "Tipo de movimiento: issue — emisión; redeem — pago con la tarjeta; refund — devolución de una compra a la tarjeta; adjust — ajuste manual; void — anulación (se devolvió la tarjeta o no se pagó); block y unblock — bloqueo y su levantamiento, sin importe; transfer_out y transfer_in — traspaso de saldo al reemitir, de la tarjeta vieja a la nueva."
                    },
                    "amount": {
                        "type": "integer",
                        "description": "Importe con signo en unidades mínimas de la moneda: positivo — la deuda creció, negativo — bajó, 0 — bloqueo y su levantamiento."
                    },
                    "balance_after": {
                        "type": "integer",
                        "description": "Saldo de la tarjeta después de este movimiento."
                    },
                    "currency": {
                        "type": "string",
                        "enum": [
                            "ARS",
                            "USD",
                            "BRL",
                            "CLP",
                            "COP",
                            "MXN",
                            "PEN",
                            "RUB"
                        ],
                        "description": "Moneda de los importes, código ISO 4217: la moneda de la tienda."
                    },
                    "order_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID del pedido."
                    },
                    "payment_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID del pago (/v1/payments): pago con el medio gift_card o el pago de la venta de la tarjeta; null si no hay pago."
                    },
                    "refund_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID de la devolución (/v1/refunds) que devolvió dinero a la tarjeta o por la tarjeta misma; null si no hay devolución."
                    },
                    "note": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Motivo del ajuste o nota del personal; null si no hay."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo se creó el registro."
                    }
                },
                "required": [
                    "id",
                    "gift_card_id",
                    "type",
                    "amount",
                    "balance_after",
                    "currency",
                    "order_id",
                    "payment_id",
                    "refund_id",
                    "note",
                    "created_at"
                ]
            },
            "GoodsReceipt": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID del registro, único entre los registros de su tipo en la tienda."
                    },
                    "number": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Número de la recepción; null en una recepción creada antes de la numeración."
                    },
                    "supplier_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID del proveedor (/v1/suppliers); null en una recepción sin proveedor."
                    },
                    "location_id": {
                        "type": "integer",
                        "description": "Local donde se recibió la mercadería (/v1/locations)."
                    },
                    "legal_entity_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Razón social compradora de la tienda (/v1/legal-entities): su régimen decide si el impuesto de la compra se computa como crédito; null en recepciones antiguas."
                    },
                    "purchase_order_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Orden de compra contra la que se recibió (/v1/purchase-orders); null si se recibió sin orden."
                    },
                    "received_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo se recibió la mercadería."
                    },
                    "currency": {
                        "type": "string",
                        "description": "Moneda de la recepción, ISO 4217: en ella van los precios del remito, los totales de línea y el subtotal."
                    },
                    "exchange_rate": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Tipo de cambio de la moneda de la recepción a la moneda de la tienda como texto decimal, tomado al recibir; null si la recepción no lo guardó."
                    },
                    "settlement_mode": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "enum": [
                            "on_receipt",
                            "on_sale",
                            null
                        ],
                        "description": "Cómo paga la tienda la entrega: on_receipt: por lo recibido; on_sale: al vender, con una liquidación de consignación; null en recepciones antiguas."
                    },
                    "supplier_document": {
                        "type": "object",
                        "properties": {
                            "type_code": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "description": "Código del tipo de comprobante del proveedor fiscal del país de la tienda (en Argentina, el código de comprobante de ARCA); null si no hay documento."
                            },
                            "number": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "description": "Número del remito; null si no se indicó."
                            },
                            "date": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "description": "Fecha del remito, YYYY-MM-DD; null si no se indicó."
                            }
                        },
                        "required": [
                            "type_code",
                            "number",
                            "date"
                        ],
                        "description": "Remito del proveedor tal como lo confirmó el personal."
                    },
                    "prices_include_tax": {
                        "type": [
                            "boolean",
                            "null"
                        ],
                        "description": "true: los precios de las líneas incluyen impuestos; false: no los incluyen; null: no se indicó."
                    },
                    "input_tax_treatment": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "enum": [
                            "recoverable",
                            "cost",
                            null
                        ],
                        "description": "Adónde fue el impuesto del precio de compra: recoverable: se computa como crédito y el costo va sin impuesto; cost: no hay contra qué computarlo y el impuesto es parte del costo; null: costo tal como se cargó."
                    },
                    "lines_subtotal": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Valor recibido: la suma de line_total en la moneda de la recepción; null si el documento no tiene precios."
                    },
                    "payable_total": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Monto que se le debe al proveedor en la moneda de la recepción; null si se desconoce."
                    },
                    "voided_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Cuándo se anuló la recepción: la mercadería salió del stock y se anuló la deuda por la entrega; null en una recepción vigente."
                    },
                    "note": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Nota del personal; null si no hay."
                    },
                    "lines": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "id": {
                                    "type": "integer",
                                    "description": "ID del registro, único entre los registros de su tipo en la tienda."
                                },
                                "variant_id": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "ID de la variante del producto (/v1/variants)."
                                },
                                "lot_id": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "Lote de la línea (/v1/lots); null en un producto sin lotes."
                                },
                                "purchase_order_line_id": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "Línea de la orden de compra (lines[].id de la orden) contra la que se recibió; null sin orden."
                                },
                                "added_by_correction_id": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "Corrección (corrections[].id) que agregó la línea; null en una línea del registro original."
                                },
                                "supplier_description": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "description": "Nombre del artículo como figura en el remito; null si no se registró."
                                },
                                "supplier_quantity": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "description": "Cantidad como figura en el remito, en supplier_unit, como texto decimal; null si no se registró."
                                },
                                "supplier_unit": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "description": "Unidad del remito tal como está escrita: «kg», «15 kg», «u»; null si no se indicó."
                                },
                                "unit": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "description": "Unidad base de quantity y cost_per_quantity: pcs, unidades; g, gramos; ml, mililitros."
                                },
                                "quantity": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "description": "Cantidad ingresada al stock, texto decimal en la unidad base."
                                },
                                "unit_cost": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "Precio del remito en la moneda de la recepción por cost_per_quantity; null si no hay precio."
                                },
                                "cost_per_quantity": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "description": "Cantidad en la unidad base a la que corresponde el precio: \"1000\" en un producto por peso es por kilo."
                                },
                                "line_total": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "Total de la línea en la moneda de la recepción: precio por la cantidad del remito; null sin precio o sin cantidad del remito."
                                },
                                "store_unit_cost_micro": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "Precio de la línea en la moneda de la tienda al tipo de cambio de la recepción por cost_per_quantity, en millonésimas de la unidad menor; null sin precio."
                                },
                                "tax_rate_bps": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "Alícuota con la que se calculó el costo, en puntos básicos; null si no hubo tratamiento del impuesto."
                                },
                                "landed_unit_cost_micro": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "Costo después del tratamiento del impuesto que la línea fijó en el artículo: moneda de la tienda, por cost_per_quantity, en millonésimas de la unidad menor; null sin precio."
                                }
                            },
                            "required": [
                                "id",
                                "variant_id",
                                "lot_id",
                                "purchase_order_line_id",
                                "added_by_correction_id",
                                "supplier_description",
                                "supplier_quantity",
                                "supplier_unit",
                                "unit",
                                "quantity",
                                "unit_cost",
                                "cost_per_quantity",
                                "line_total",
                                "store_unit_cost_micro",
                                "tax_rate_bps",
                                "landed_unit_cost_micro"
                            ]
                        },
                        "description": "Líneas de la recepción; los valores son después de las correcciones."
                    },
                    "corrections": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "id": {
                                    "type": "integer",
                                    "description": "ID del registro, único entre los registros de su tipo en la tienda."
                                },
                                "number": {
                                    "type": "string",
                                    "description": "Número de la corrección."
                                },
                                "reason": {
                                    "type": "string",
                                    "description": "Por qué se corrigió, con las palabras del personal."
                                },
                                "subtotal_before": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "lines_subtotal antes de la corrección; null si no había precios."
                                },
                                "subtotal_after": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "lines_subtotal después de la corrección; null si no hay precios."
                                },
                                "consumed_variance": {
                                    "type": "integer",
                                    "description": "Diferencia de precio sobre lo que ya había salido del stock, en la moneda de la tienda: fue al costo de lo vendido."
                                },
                                "lines": {
                                    "type": "array",
                                    "items": {
                                        "type": "object",
                                        "properties": {
                                            "goods_receipt_line_id": {
                                                "type": "integer",
                                                "description": "ID de la línea de la recepción (lines[].id)."
                                            },
                                            "quantity_before": {
                                                "type": [
                                                    "string",
                                                    "null"
                                                ],
                                                "description": "Cantidad recibida antes de la corrección, en la unidad base."
                                            },
                                            "quantity_after": {
                                                "type": [
                                                    "string",
                                                    "null"
                                                ],
                                                "description": "Cantidad recibida después de la corrección, en la unidad base."
                                            },
                                            "supplier_quantity_before": {
                                                "type": [
                                                    "string",
                                                    "null"
                                                ],
                                                "description": "Cantidad del remito antes de la corrección; null si no había."
                                            },
                                            "supplier_quantity_after": {
                                                "type": [
                                                    "string",
                                                    "null"
                                                ],
                                                "description": "Cantidad del remito después de la corrección; null si no hay."
                                            },
                                            "unit_cost_before": {
                                                "type": [
                                                    "integer",
                                                    "null"
                                                ],
                                                "description": "Precio del remito antes de la corrección; null si no había precio."
                                            },
                                            "unit_cost_after": {
                                                "type": [
                                                    "integer",
                                                    "null"
                                                ],
                                                "description": "Precio del remito después de la corrección; null si no hay precio."
                                            },
                                            "store_unit_cost_before_micro": {
                                                "type": [
                                                    "integer",
                                                    "null"
                                                ],
                                                "description": "Precio en la moneda de la tienda antes de la corrección, en millonésimas de la unidad menor."
                                            },
                                            "store_unit_cost_after_micro": {
                                                "type": [
                                                    "integer",
                                                    "null"
                                                ],
                                                "description": "Precio en la moneda de la tienda después de la corrección, en millonésimas de la unidad menor."
                                            },
                                            "consumed_quantity": {
                                                "type": [
                                                    "string",
                                                    "null"
                                                ],
                                                "description": "Cuánto de la línea ya había salido del stock al momento de la corrección."
                                            },
                                            "consumed_variance": {
                                                "type": "integer",
                                                "description": "Diferencia de precio sobre lo que salió del stock, en la moneda de la tienda."
                                            }
                                        },
                                        "required": [
                                            "goods_receipt_line_id",
                                            "quantity_before",
                                            "quantity_after",
                                            "supplier_quantity_before",
                                            "supplier_quantity_after",
                                            "unit_cost_before",
                                            "unit_cost_after",
                                            "store_unit_cost_before_micro",
                                            "store_unit_cost_after_micro",
                                            "consumed_quantity",
                                            "consumed_variance"
                                        ]
                                    },
                                    "description": "Líneas corregidas, antes y después."
                                },
                                "created_at": {
                                    "type": "string",
                                    "format": "date-time",
                                    "description": "Cuándo se registró la corrección."
                                }
                            },
                            "required": [
                                "id",
                                "number",
                                "reason",
                                "subtotal_before",
                                "subtotal_after",
                                "consumed_variance",
                                "lines",
                                "created_at"
                            ]
                        },
                        "description": "Correcciones de la recepción registrada en orden: qué se corrigió y por qué."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo se creó el registro."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo cambió el registro por última vez."
                    }
                },
                "required": [
                    "id",
                    "number",
                    "supplier_id",
                    "location_id",
                    "legal_entity_id",
                    "purchase_order_id",
                    "received_at",
                    "currency",
                    "exchange_rate",
                    "settlement_mode",
                    "supplier_document",
                    "prices_include_tax",
                    "input_tax_treatment",
                    "lines_subtotal",
                    "payable_total",
                    "voided_at",
                    "note",
                    "lines",
                    "corrections",
                    "created_at",
                    "updated_at"
                ]
            },
            "InventoryChange": {
                "type": "object",
                "properties": {
                    "status": {
                        "type": "string",
                        "enum": [
                            "applied",
                            "unchanged",
                            "pending_approval"
                        ],
                        "description": "Resultado de la escritura: applied — el stock cambió; unchanged — el stock ya tenía ese valor; pending_approval — la baja espera aprobación en la tienda: on_hand aún no cambió, available ya excluye la cantidad retenida."
                    },
                    "inventory_level": {
                        "$ref": "#/components/schemas/InventoryLevel",
                        "description": "Nivel de stock del par después de la escritura."
                    }
                },
                "required": [
                    "status",
                    "inventory_level"
                ]
            },
            "InventoryLevel": {
                "type": "object",
                "properties": {
                    "variant_id": {
                        "type": "integer",
                        "description": "ID de la variante. Junto con location_id identifica el nivel de stock; un par que no está en la lista tiene stock cero."
                    },
                    "location_id": {
                        "type": "integer",
                        "description": "ID del local de la tienda."
                    },
                    "on_hand": {
                        "type": "string",
                        "description": "Stock físico del local en todas sus ubicaciones, como cadena decimal en la unidad de la variante. Fijar el stock nombra y verifica este valor."
                    },
                    "reserved": {
                        "type": "string",
                        "description": "Cantidad reservada para pedidos, como cadena decimal en la unidad de la variante."
                    },
                    "available": {
                        "type": "string",
                        "description": "Cantidad que se puede vender: stock disponible para preparar menos las reservas, como cadena decimal. Negativa si se vendió más de lo que había."
                    },
                    "updated_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Cuándo cambió el stock por última vez; null si el par aún no tuvo movimientos."
                    }
                },
                "required": [
                    "variant_id",
                    "location_id",
                    "on_hand",
                    "reserved",
                    "available",
                    "updated_at"
                ]
            },
            "LegalEntity": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID del registro, único entre los registros de su tipo en la tienda."
                    },
                    "name": {
                        "type": "string",
                        "description": "Nombre de la razón social tal como figura ante el fisco."
                    },
                    "tax_id": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Identificación fiscal en el país de la tienda (CUIT en Argentina, 11 dígitos); null si no está cargada."
                    },
                    "tax_status": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "enum": [
                            "registered",
                            "small_taxpayer",
                            "exempt",
                            null
                        ],
                        "description": "Condición fiscal: registered — contribuyente de IVA (Responsable Inscripto en Argentina); small_taxpayer — régimen simplificado (Monotributo); exempt — exento de IVA. null si no está cargada."
                    },
                    "is_default": {
                        "type": "boolean",
                        "description": "La razón social predeterminada: recibe las ventas no asignadas a otras razones sociales y los comprobantes sin emisor."
                    },
                    "is_active": {
                        "type": "boolean",
                        "description": "false — la razón social está desactivada: no recibe ventas nuevas; sus comprobantes y períodos se conservan."
                    },
                    "issues_fiscal_documents": {
                        "type": "boolean",
                        "description": "Si la razón social emite comprobantes fiscales; false — sus ventas van sin comprobante."
                    },
                    "ar": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "properties": {
                            "tax_condition": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "enum": [
                                    "responsable_inscripto",
                                    "monotributo",
                                    "exento",
                                    null
                                ],
                                "description": "Condición frente al IVA: responsable_inscripto, monotributo o exento; null si no está cargada."
                            },
                            "regime_category": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "description": "Categoría del Monotributo (A…K); null si no está cargada."
                            },
                            "regime_activity_kind": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "enum": [
                                    "services",
                                    "goods",
                                    null
                                ],
                                "description": "Actividad del monotributista, de la que depende la cuota: services — servicios, goods — venta de bienes; null si no está cargada."
                            }
                        },
                        "required": [
                            "tax_condition",
                            "regime_category",
                            "regime_activity_kind"
                        ],
                        "description": "Datos propios de Argentina; null en una tienda de otro país."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo se creó el registro."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo cambió el registro por última vez."
                    }
                },
                "required": [
                    "id",
                    "name",
                    "tax_id",
                    "tax_status",
                    "is_default",
                    "is_active",
                    "issues_fiscal_documents",
                    "ar",
                    "created_at",
                    "updated_at"
                ]
            },
            "Locale": {
                "type": "string",
                "enum": [
                    "ru",
                    "en",
                    "es"
                ]
            },
            "Location": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID del registro, único entre los registros de su tipo en la tienda."
                    },
                    "name": {
                        "type": "object",
                        "additionalProperties": {
                            "type": "string"
                        },
                        "description": "Nombre por idioma: un objeto con los idiomas completados, por ejemplo {\"es\": \"Café\", \"en\": \"Coffee\"}."
                    },
                    "address": {
                        "type": "string",
                        "description": "Dirección del local en una línea."
                    },
                    "coordinates": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "properties": {
                            "lat": {
                                "type": "number",
                                "description": "Latitud en grados."
                            },
                            "lng": {
                                "type": "number",
                                "description": "Longitud en grados."
                            }
                        },
                        "required": [
                            "lat",
                            "lng"
                        ],
                        "description": "Ubicación del local en el mapa; null si no está definida. Un local sin ella no se muestra en el mapa de la tienda online."
                    },
                    "phone": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Teléfono del local; null si no está definido."
                    },
                    "is_active": {
                        "type": "boolean",
                        "description": "false si la tienda desactivó el local."
                    },
                    "is_default": {
                        "type": "boolean",
                        "description": "El local principal de la tienda: los pedidos con envío toman stock de él si no se eligió otro local. La tienda tiene uno."
                    },
                    "is_pickup_point": {
                        "type": "boolean",
                        "description": "Los clientes pueden retirar pedidos en el local."
                    },
                    "is_stock_source": {
                        "type": "boolean",
                        "description": "El local guarda mercadería: tiene stock, recibe entregas, hace inventarios y transferencias."
                    },
                    "fulfills_online_orders": {
                        "type": "boolean",
                        "description": "El stock del local se vende a los clientes online. Tiene sentido solo con is_stock_source en true: una cocina guarda mercadería pero no la vende."
                    },
                    "price_list_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Lista de precios del local: sus precios de venta sobre los precios base. null — el local vende a precios base. Una lista puede servir a varios locales."
                    },
                    "working_hours": {
                        "type": "object",
                        "additionalProperties": {
                            "type": "array",
                            "items": {
                                "type": "object",
                                "properties": {
                                    "from": {
                                        "type": "string",
                                        "description": "Inicio del intervalo, HH:MM."
                                    },
                                    "to": {
                                        "type": "string",
                                        "description": "Fin del intervalo, HH:MM. Un fin anterior al inicio significa que el intervalo pasa la medianoche."
                                    }
                                },
                                "required": [
                                    "from",
                                    "to"
                                ]
                            }
                        },
                        "description": "Horario de atención: día de la semana (mon, tue, wed, thu, fri, sat, sun) → lista de intervalos en la zona horaria de la tienda. Un día sin intervalos está cerrado."
                    },
                    "temporarily_closed_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Cuándo el local cerró temporalmente; null si está abierto."
                    },
                    "reopens_on": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date",
                        "description": "Fecha en que el local cerrado temporalmente vuelve a abrir, en la zona horaria de la tienda; null si está abierto o la fecha no se conoce."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo se creó el registro."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo cambió el registro por última vez."
                    }
                },
                "required": [
                    "id",
                    "name",
                    "address",
                    "coordinates",
                    "phone",
                    "is_active",
                    "is_default",
                    "is_pickup_point",
                    "is_stock_source",
                    "fulfills_online_orders",
                    "price_list_id",
                    "working_hours",
                    "temporarily_closed_at",
                    "reopens_on",
                    "created_at",
                    "updated_at"
                ]
            },
            "LocationTransfer": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID del registro, único entre los registros de su tipo en la tienda."
                    },
                    "number": {
                        "type": "string",
                        "description": "Número del traslado en la tienda."
                    },
                    "source_location_id": {
                        "type": "integer",
                        "description": "ID del local del que salió la mercadería (/v1/locations)."
                    },
                    "destination_location_id": {
                        "type": "integer",
                        "description": "ID del local al que llegó la mercadería (/v1/locations)."
                    },
                    "origin": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "enum": [
                            "location_drain",
                            "reversal",
                            null
                        ],
                        "description": "De dónde vino el traslado si no lo creó una persona: location_drain — retiro del stock al desactivar un local; reversal — devolución de un traslado registrado. null — lo creó un empleado."
                    },
                    "reverses_location_transfer_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID del traslado que este devuelve; null en un traslado común."
                    },
                    "comment": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Comentario del empleado; null si no lo hay."
                    },
                    "lines": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "id": {
                                    "type": "integer",
                                    "description": "ID del registro, único entre los registros de su tipo en la tienda."
                                },
                                "variant_id": {
                                    "type": "integer",
                                    "description": "ID de la variante del producto (/v1/variants)."
                                },
                                "lot_id": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "ID del lote (/v1/lots); null — mercadería sin lotes."
                                },
                                "quantity": {
                                    "type": "string",
                                    "description": "Cantidad trasladada, como cadena decimal en la unidad de la variante."
                                }
                            },
                            "required": [
                                "id",
                                "variant_id",
                                "lot_id",
                                "quantity"
                            ]
                        },
                        "description": "Líneas del traslado: qué se movió y cuánto. Los movimientos de stock del traslado son una salida en el local de origen y una entrada en el de destino con document.type = location_transfer."
                    },
                    "executed_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Momento en que se registró el traslado."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo se creó el registro."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo cambió el registro por última vez."
                    }
                },
                "required": [
                    "id",
                    "number",
                    "source_location_id",
                    "destination_location_id",
                    "origin",
                    "reverses_location_transfer_id",
                    "comment",
                    "lines",
                    "executed_at",
                    "created_at",
                    "updated_at"
                ]
            },
            "Lot": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID del registro, único entre los registros de su tipo en la tienda."
                    },
                    "variant_id": {
                        "type": "integer",
                        "description": "ID de la variante del producto (/v1/variants)."
                    },
                    "number": {
                        "type": "string",
                        "description": "Número de lote — del envase del proveedor o asignado por la tienda; no se repite dentro de la variante."
                    },
                    "expires_on": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date",
                        "description": "Vence el, como fecha contable YYYY-MM-DD; null sin vencimiento."
                    },
                    "status": {
                        "type": "string",
                        "enum": [
                            "available",
                            "hold",
                            "quarantine"
                        ],
                        "description": "Disponibilidad: available — a la venta; hold — retenido; quarantine — en cuarentena. Un lote retenido o en cuarentena sigue en stock pero no se vende ni se prepara."
                    },
                    "received_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Momento en que el lote entró al stock."
                    },
                    "document": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "properties": {
                            "type": {
                                "type": "string",
                                "enum": [
                                    "goods_receipt",
                                    "production_order",
                                    "stocktake"
                                ],
                                "description": "Tipo de documento: goods_receipt — recepción (/v1/goods-receipts); production_order — acta de producción; stocktake — inventario que encontró la mercadería."
                            },
                            "id": {
                                "type": "integer",
                                "description": "ID del documento."
                            }
                        },
                        "required": [
                            "type",
                            "id"
                        ],
                        "description": "Documento con el que entró el lote; null si el lote se asignó al stock sin documento."
                    },
                    "merged_into_lot_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID del lote en el que se fusionó este: el stock y los movimientos siguen en él; null en un lote independiente."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo se creó el registro."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo cambió el registro por última vez."
                    }
                },
                "required": [
                    "id",
                    "variant_id",
                    "number",
                    "expires_on",
                    "status",
                    "received_at",
                    "document",
                    "merged_into_lot_id",
                    "created_at",
                    "updated_at"
                ]
            },
            "ManualPaymentMethod": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID del registro, único entre los registros de su tipo en la tienda."
                    },
                    "code": {
                        "type": "string",
                        "description": "Código del registro, único en la tienda: no cambia al renombrar el registro."
                    },
                    "name": {
                        "type": "object",
                        "additionalProperties": {
                            "type": "string"
                        },
                        "description": "Nombre del medio de pago por idioma."
                    },
                    "settlement_currency": {
                        "type": "string",
                        "description": "Moneda en la que llega el dinero del medio, código ISO 4217."
                    },
                    "settles_on_receipt": {
                        "type": "boolean",
                        "description": "El cliente paga al recibir el pedido, por ejemplo con una transferencia al cadete; false — antes de preparar el pedido."
                    },
                    "is_active": {
                        "type": "boolean",
                        "description": "false — los clientes no pueden elegir el medio."
                    },
                    "position": {
                        "type": "integer",
                        "description": "Posición en el orden: la menor va primero."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo se creó el registro."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo cambió el registro por última vez."
                    },
                    "deleted_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Cuándo se archivó el registro; null en un registro vigente."
                    }
                },
                "required": [
                    "id",
                    "code",
                    "name",
                    "settlement_currency",
                    "settles_on_receipt",
                    "is_active",
                    "position",
                    "created_at",
                    "updated_at",
                    "deleted_at"
                ]
            },
            "Me": {
                "type": "object",
                "properties": {
                    "app": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "integer",
                                "description": "ID de la aplicación."
                            },
                            "name": {
                                "type": "string",
                                "description": "Nombre de la aplicación que le dio la tienda."
                            },
                            "description": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "description": "Descripción de la aplicación; null si la tienda no la escribió."
                            },
                            "scopes": {
                                "type": "array",
                                "items": {
                                    "type": "string"
                                },
                                "description": "Scopes otorgados a la aplicación: qué pueden leer y cambiar sus tokens."
                            },
                            "allowed_ips": {
                                "type": [
                                    "array",
                                    "null"
                                ],
                                "items": {
                                    "type": "string"
                                },
                                "description": "Direcciones IP y rangos CIDR desde los que la aplicación puede llamar; null significa cualquier dirección."
                            },
                            "all_locations": {
                                "type": "boolean",
                                "description": "true si la aplicación trabaja con todos los locales de la tienda, incluidos los que se agreguen después."
                            },
                            "location_ids": {
                                "type": [
                                    "array",
                                    "null"
                                ],
                                "items": {
                                    "type": "integer"
                                },
                                "description": "Locales con los que trabaja la aplicación cuando all_locations es false; null si trabaja con todos."
                            },
                            "created_at": {
                                "type": "string",
                                "format": "date-time",
                                "description": "Cuándo se creó la aplicación."
                            }
                        },
                        "required": [
                            "id",
                            "name",
                            "description",
                            "scopes",
                            "allowed_ips",
                            "all_locations",
                            "location_ids",
                            "created_at"
                        ],
                        "description": "La aplicación a la que pertenece el token."
                    },
                    "token": {
                        "type": "object",
                        "properties": {
                            "name": {
                                "type": "string",
                                "description": "Nombre del token dado al emitirlo."
                            },
                            "prefix": {
                                "type": "string",
                                "description": "Prefijo visible del token: distingue los tokens sin revelarlos."
                            },
                            "expires_at": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "format": "date-time",
                                "description": "Cuándo vence el token; null si no vence."
                            }
                        },
                        "required": [
                            "name",
                            "prefix",
                            "expires_at"
                        ],
                        "description": "El token de esta solicitud."
                    },
                    "store_id": {
                        "type": "integer",
                        "description": "ID de la tienda a la que pertenece el token."
                    },
                    "rate_limits": {
                        "type": "object",
                        "properties": {
                            "app": {
                                "type": "object",
                                "properties": {
                                    "per_minute": {
                                        "type": "integer",
                                        "description": "Solicitudes por minuto con las que se recarga el balde."
                                    },
                                    "burst": {
                                        "type": "integer",
                                        "description": "Solicitudes que se pueden enviar seguidas antes de que rija el ritmo por minuto."
                                    }
                                },
                                "required": [
                                    "per_minute",
                                    "burst"
                                ],
                                "description": "Balde de la aplicación, compartido por todos sus tokens."
                            },
                            "store": {
                                "type": "object",
                                "properties": {
                                    "per_minute": {
                                        "type": "integer",
                                        "description": "Solicitudes por minuto con las que se recarga el balde."
                                    },
                                    "burst": {
                                        "type": "integer",
                                        "description": "Solicitudes que se pueden enviar seguidas antes de que rija el ritmo por minuto."
                                    }
                                },
                                "required": [
                                    "per_minute",
                                    "burst"
                                ],
                                "description": "Balde de la tienda, compartido por todas sus aplicaciones."
                            }
                        },
                        "required": [
                            "app",
                            "store"
                        ],
                        "description": "Límites de solicitudes de la aplicación."
                    }
                },
                "required": [
                    "app",
                    "token",
                    "store_id",
                    "rate_limits"
                ]
            },
            "MediaImport": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID del registro, único entre los registros de su tipo en la tienda."
                    },
                    "app_id": {
                        "type": "integer",
                        "description": "ID de la aplicación que pidió la descarga."
                    },
                    "product_id": {
                        "type": "integer",
                        "description": "ID del producto al que va la foto."
                    },
                    "url": {
                        "type": "string",
                        "description": "Dirección desde la que se descarga la foto."
                    },
                    "position": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Lugar en la galería, desde cero; null — al final."
                    },
                    "is_primary": {
                        "type": "boolean",
                        "description": "La foto pasa a ser la principal."
                    },
                    "status": {
                        "type": "string",
                        "enum": [
                            "pending",
                            "succeeded",
                            "failed"
                        ],
                        "description": "pending — en espera o descargándose; succeeded — la foto está en la galería (media_id); failed — la foto no se agregó (error)."
                    },
                    "media_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "La foto en la galería, el id en media del producto; presente cuando status es succeeded."
                    },
                    "error": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "properties": {
                            "code": {
                                "type": "string",
                                "enum": [
                                    "invalid_url",
                                    "blocked_address",
                                    "unreachable",
                                    "too_large",
                                    "access_denied",
                                    "not_found",
                                    "rate_limited",
                                    "http_error",
                                    "not_an_image",
                                    "image_dimensions_exceeded",
                                    "media_quota_exceeded",
                                    "product_deleted",
                                    "processing_failed"
                                ],
                                "description": "invalid_url — no es una dirección http ni https; blocked_address — la dirección lleva a una red privada; unreachable — el servidor no respondió; too_large — el archivo supera el tamaño permitido; access_denied, not_found, rate_limited, http_error — el servidor respondió con un error (source_status); not_an_image — el archivo no es una imagen; image_dimensions_exceeded — la imagen tiene demasiados píxeles; media_quota_exceeded — la biblioteca de medios de la tienda está llena; product_deleted — el producto se archivó antes de que llegara la foto; processing_failed — la imagen no se pudo procesar."
                            },
                            "message": {
                                "type": "string",
                                "description": "El motivo en palabras, en el idioma de la solicitud."
                            },
                            "source_status": {
                                "type": [
                                    "integer",
                                    "null"
                                ],
                                "description": "Estado HTTP con el que respondió el servidor de la foto, en access_denied, not_found, rate_limited y http_error; si no, null."
                            }
                        },
                        "required": [
                            "code",
                            "message",
                            "source_status"
                        ],
                        "description": "Por qué no se agregó la foto; presente cuando status es failed."
                    },
                    "attempts": {
                        "type": "integer",
                        "description": "Cuántas veces se tomó la descarga: las fallas de red y del origen se reintentan."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo se creó el registro."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo cambió el registro por última vez."
                    },
                    "finished_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Cuándo terminó la descarga; null mientras está en pending."
                    }
                },
                "required": [
                    "id",
                    "app_id",
                    "product_id",
                    "url",
                    "position",
                    "is_primary",
                    "status",
                    "media_id",
                    "error",
                    "attempts",
                    "created_at",
                    "updated_at",
                    "finished_at"
                ]
            },
            "ModifierGroup": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID del registro, único entre los registros de su tipo en la tienda."
                    },
                    "external_id": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "ID externo: el ID del registro en tu sistema; null si la aplicación no lo fijó. Cada aplicación ve solo sus propios ID."
                    },
                    "version": {
                        "type": "integer",
                        "description": "Versión del registro: crece con cada cambio. Para cambiar el registro, envíela como ETag en If-Match."
                    },
                    "name": {
                        "type": "object",
                        "additionalProperties": {
                            "type": "string"
                        },
                        "description": "Nombre por idioma: un objeto con los idiomas completados, por ejemplo {\"es\": \"Café\", \"en\": \"Coffee\"}."
                    },
                    "min_select": {
                        "type": "integer",
                        "description": "Cuántas opciones debe elegir el cliente: 0 — el grupo es opcional. Un producto puede fijar su propia regla (selection_rule)."
                    },
                    "max_select": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Cuántas opciones se pueden elegir en total, con repeticiones; null — sin límite."
                    },
                    "is_active": {
                        "type": "boolean",
                        "description": "false — el grupo está apagado y no se ofrece en los productos."
                    },
                    "adds_ingredients": {
                        "type": "boolean",
                        "description": "Si las opciones del grupo cambian la composición del plato; con true, una opción sin composición propia deja desconocida la composición del ítem (alérgenos)."
                    },
                    "options": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "id": {
                                    "type": "integer",
                                    "description": "ID del registro, único entre los registros de su tipo en la tienda."
                                },
                                "external_id": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "description": "ID externo: el ID del registro en tu sistema; null si la aplicación no lo fijó. Cada aplicación ve solo sus propios ID."
                                },
                                "name": {
                                    "type": "object",
                                    "additionalProperties": true,
                                    "description": "Nombre por idioma: un objeto con los idiomas completados, por ejemplo {\"es\": \"Café\", \"en\": \"Coffee\"}."
                                },
                                "price_delta": {
                                    "type": "integer",
                                    "description": "Recargo sobre el precio del ítem por porción de la opción, entero en unidades menores de la moneda de la tienda; negativo — un descuento. Un producto puede fijar su propio recargo por variante."
                                },
                                "max_quantity": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "Cuántas veces se puede tomar la opción en un ítem; null — sin límite propio, rige solo el max_select del grupo."
                                },
                                "duration_minutes": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "Cuántos minutos suma la opción a un servicio con turno, múltiplo de 5; null — ninguno. No aplica a otros tipos de ítems."
                                },
                                "is_active": {
                                    "type": "boolean",
                                    "description": "false — la opción está apagada y no se ofrece."
                                },
                                "is_default": {
                                    "type": "boolean",
                                    "description": "La opción viene preseleccionada: la tienda y el POS la marcan de entrada, y el servidor completa con ella un grupo obligatorio vacío."
                                },
                                "adds_ingredients": {
                                    "type": [
                                        "boolean",
                                        "null"
                                    ],
                                    "description": "Si esta opción cambia la composición; null — como el grupo (adds_ingredients)."
                                },
                                "recipe_per_variant": {
                                    "type": "boolean",
                                    "description": "El consumo depende del plato: sin composición general, la cantidad la fija la receta de cada variante (option_recipes); sin ella la opción no se ofrece en esa variante."
                                },
                                "nutrition": {
                                    "type": [
                                        "object",
                                        "null"
                                    ],
                                    "properties": {
                                        "kcal": {
                                            "type": "integer",
                                            "description": "Energía, kcal."
                                        },
                                        "protein_mg": {
                                            "type": "integer",
                                            "description": "Proteínas, mg."
                                        },
                                        "fat_mg": {
                                            "type": "integer",
                                            "description": "Grasas, mg."
                                        },
                                        "carbs_mg": {
                                            "type": "integer",
                                            "description": "Carbohidratos, mg."
                                        }
                                    },
                                    "required": [
                                        "kcal",
                                        "protein_mg",
                                        "fat_mg",
                                        "carbs_mg"
                                    ],
                                    "description": "Valor nutricional de un uso de la opción declarado por la tienda: los cuatro números o null — entonces lo calcula la composición de la opción."
                                },
                                "recipe": {
                                    "type": "array",
                                    "items": {
                                        "type": "object",
                                        "properties": {
                                            "variant_id": {
                                                "type": "integer",
                                                "description": "ID de la variante del producto."
                                            },
                                            "quantity": {
                                                "type": [
                                                    "string",
                                                    "null"
                                                ],
                                                "description": "Cantidad del componente por un uso de la opción, como texto decimal en la unidad del componente; null — a gusto: en la composición pero sin consumo."
                                            }
                                        },
                                        "required": [
                                            "variant_id",
                                            "quantity"
                                        ]
                                    },
                                    "description": "Composición general de la opción — lo que consume en cualquier plato: insumos y preelaborados con su cantidad. Vacía en una opción por plato. Al escribir, la lista completa, una vacía la limpia; sin el campo la composición queda como está."
                                }
                            },
                            "required": [
                                "id",
                                "external_id",
                                "name",
                                "price_delta",
                                "max_quantity",
                                "duration_minutes",
                                "is_active",
                                "is_default",
                                "adds_ingredients",
                                "recipe_per_variant",
                                "nutrition",
                                "recipe"
                            ]
                        },
                        "description": "Opciones en orden de exhibición. Al escribir, el conjunto completo: una fila encuentra su opción por id o external_id, a la encontrada se le escriben los campos enviados, una fila sin opción es nueva y lleva name; una opción que falta en el conjunto se archiva y se quita de los borradores de pedido abiertos."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo se creó el registro."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo cambió el registro por última vez."
                    },
                    "deleted_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Cuándo se archivó el registro; null en un registro vigente."
                    }
                },
                "required": [
                    "id",
                    "external_id",
                    "version",
                    "name",
                    "min_select",
                    "max_select",
                    "is_active",
                    "adds_ingredients",
                    "options",
                    "created_at",
                    "updated_at",
                    "deleted_at"
                ]
            },
            "MoneyAccount": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID del registro, único entre los registros de su tipo en la tienda."
                    },
                    "name": {
                        "type": "string",
                        "description": "Nombre de la cuenta como lo ve la tienda."
                    },
                    "type": {
                        "type": "string",
                        "enum": [
                            "bank",
                            "cash",
                            "acquiring",
                            "ewallet",
                            "crypto",
                            "advance",
                            "transit",
                            "group_share"
                        ],
                        "description": "Tipo de cuenta: bank — banco; cash — efectivo; acquiring — adquirente (proveedor de pagos); ewallet — billetera virtual; crypto — billetera cripto; advance — fondos a rendir del local; transit — dinero en tránsito (remesa); group_share — parte en una cuenta común del grupo de tiendas: el dinero está en la del titular y el saldo es la cuenta con el grupo."
                    },
                    "currency": {
                        "type": "string",
                        "description": "Moneda de la cuenta: código ISO 4217 o de un activo (USDT). Puede diferir de la moneda de la tienda."
                    },
                    "balance": {
                        "type": "string",
                        "description": "Saldo actual en la moneda de la cuenta, como cadena decimal, por ejemplo \"12345.5\"."
                    },
                    "legal_entity_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID de la razón social dueña de la cuenta; null — cuenta de la tienda sin razón social."
                    },
                    "location_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID del local de la cuenta; null — cuenta común de la tienda."
                    },
                    "is_default": {
                        "type": "boolean",
                        "description": "Cuenta predeterminada de su moneda."
                    },
                    "is_system": {
                        "type": "boolean",
                        "description": "Cuenta de sistema de la caja (advance, transit): solo la mueven los documentos de la caja."
                    },
                    "archived_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Cuándo se archivó la cuenta: no acepta movimientos nuevos y su historial queda. null si está activa."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo se creó el registro."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo cambió el registro por última vez."
                    }
                },
                "required": [
                    "id",
                    "name",
                    "type",
                    "currency",
                    "balance",
                    "legal_entity_id",
                    "location_id",
                    "is_default",
                    "is_system",
                    "archived_at",
                    "created_at",
                    "updated_at"
                ]
            },
            "MoneyCategory": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID del registro, único entre los registros de su tipo en la tienda."
                    },
                    "parent_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID de la categoría padre; null en una categoría de primer nivel."
                    },
                    "kind": {
                        "type": "string",
                        "enum": [
                            "income",
                            "expense"
                        ],
                        "description": "income — categoría de ingresos; expense — categoría de egresos."
                    },
                    "name": {
                        "type": "object",
                        "additionalProperties": {
                            "type": "string"
                        },
                        "description": "Nombre por idioma: un objeto con los idiomas completados, por ejemplo {\"es\": \"Café\", \"en\": \"Coffee\"}."
                    },
                    "system_code": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "enum": [
                            "sales",
                            "tips",
                            "other_income",
                            "carrier_claims",
                            "supplier_refunds",
                            "financing_surcharge",
                            "cash_overage",
                            "exchange_gain",
                            "customer_refunds",
                            "cash_shortage",
                            "exchange_loss",
                            "goods_purchase",
                            "payroll",
                            "rent",
                            "utilities",
                            "marketplace_fees",
                            "acquiring_fees",
                            "bank_fees",
                            "taxes",
                            "logistics",
                            "advertising",
                            "other_expense",
                            null
                        ],
                        "description": "Código de la categoría del sistema — la categoría se reconoce por él y no por su nombre: sales — ventas, acquiring_fees — comisiones del adquirente, taxes — impuestos, cash_shortage y cash_overage — faltante y sobrante de caja, entre otros. null en una categoría creada por la tienda."
                    },
                    "position": {
                        "type": "integer",
                        "description": "Posición en el orden: la menor va primero."
                    },
                    "archived_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Cuándo se archivó la categoría: ya no se le asientan movimientos nuevos. null si está activa."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo se creó el registro."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo cambió el registro por última vez."
                    }
                },
                "required": [
                    "id",
                    "parent_id",
                    "kind",
                    "name",
                    "system_code",
                    "position",
                    "archived_at",
                    "created_at",
                    "updated_at"
                ]
            },
            "MoneyTransaction": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID del registro, único entre los registros de su tipo en la tienda."
                    },
                    "version": {
                        "type": "integer",
                        "description": "Versión del registro: crece con cada cambio. Para cambiar el registro, envíela como ETag en If-Match."
                    },
                    "account_id": {
                        "type": "integer",
                        "description": "ID de la cuenta de dinero del movimiento."
                    },
                    "direction": {
                        "type": "string",
                        "enum": [
                            "income",
                            "expense"
                        ],
                        "description": "income — ingreso a la cuenta; expense — egreso de la cuenta."
                    },
                    "amount": {
                        "type": "integer",
                        "description": "Importe del asiento en unidades mínimas de la moneda de la tienda, siempre positivo: el signo lo da direction. En una cuenta en otra moneda, convertido al tipo de cambio de la foto."
                    },
                    "currency": {
                        "type": "string",
                        "description": "Moneda de los importes, código ISO 4217: la moneda de la tienda."
                    },
                    "account_amount": {
                        "type": "string",
                        "description": "Importe en la moneda de la cuenta, como cadena decimal."
                    },
                    "account_currency": {
                        "type": "string",
                        "description": "Moneda de la cuenta: código ISO 4217 o de un activo (USDT)."
                    },
                    "exchange_rate": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Tipo de cambio de la foto: 1 unidad de la moneda de la cuenta = exchange_rate unidades de la moneda de la tienda, como cadena decimal. null en una cuenta en la moneda de la tienda."
                    },
                    "occurred_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Momento del movimiento."
                    },
                    "occurred_on": {
                        "type": "string",
                        "format": "date",
                        "description": "Fecha contable, YYYY-MM-DD en la zona horaria de la tienda."
                    },
                    "category_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID de la categoría; null en una transferencia entre cuentas o un movimiento sin categoría."
                    },
                    "supplier_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID del proveedor contraparte; null si no hay."
                    },
                    "transfer_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID común de las patas de una transferencia entre cuentas: el egreso de una cuenta y el ingreso a la otra comparten el mismo. null si no es una transferencia."
                    },
                    "reverses_transaction_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID del movimiento que este revierte; null en un movimiento común."
                    },
                    "origin": {
                        "type": "string",
                        "enum": [
                            "manual",
                            "statement",
                            "sales",
                            "refunds",
                            "disputes",
                            "pos",
                            "suppliers",
                            "payroll",
                            "opening_balance",
                            "exchange_differences",
                            "group_stores"
                        ],
                        "description": "Clase de origen: manual — cargado por una persona; sales — ventas; refunds — reembolsos; disputes — reclamos; pos — caja y caja fuerte; suppliers — proveedores; payroll — sueldos; statement — extracto; opening_balance — saldo inicial; exchange_differences — diferencias de cambio; group_stores — operaciones de tiendas del grupo en una cuenta común."
                    },
                    "source": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "properties": {
                            "type": {
                                "type": "string",
                                "enum": [
                                    "payment",
                                    "payment_tip",
                                    "payment_tip_refund",
                                    "payment_surcharge",
                                    "payment_surcharge_refund",
                                    "payment_overpayment",
                                    "payment_change",
                                    "payment_change_counter",
                                    "payment_provider_fee",
                                    "payment_provider_fee_refund",
                                    "payment_withheld_tax",
                                    "payment_withheld_tax_refund",
                                    "refund",
                                    "dispute",
                                    "pos_shift",
                                    "pos_shift_drawer",
                                    "pos_cash_transfer",
                                    "pos_cash_transfer_counter",
                                    "pos_cash_shared_safe",
                                    "pos_cash_shared_safe_counter",
                                    "pos_cash_movement",
                                    "pos_drawer_movement",
                                    "pos_cash_advance_expense",
                                    "pos_cash_advance_expense_void",
                                    "pos_cash_bank_credit",
                                    "pos_cash_bank_credit_counter",
                                    "pos_cash_bank_credit_difference",
                                    "payroll_period",
                                    "purchase_order",
                                    "supplier_bill_payment",
                                    "supplier_return_refund",
                                    "statement_line",
                                    "opening_balance",
                                    "exchange_difference",
                                    "group_member_operation"
                                ],
                                "description": "Tipo de asiento. payment y payment_* — el ingreso de un pago y sus partes (propina, recargo, vuelto, comisión del proveedor, impuesto retenido); refund — el pago de un reembolso; pos_* — documentos de la caja; supplier_bill_payment — el pago de una factura de proveedor; exchange_difference — una diferencia de cambio."
                            },
                            "id": {
                                "type": [
                                    "integer",
                                    "null"
                                ],
                                "description": "ID del registro de origen: en payment y payment_*, el ID del pago; en refund, un ID de transactions[] del reembolso; en exchange_difference, el ID del movimiento de egreso; en el resto, un ID interno."
                            }
                        },
                        "required": [
                            "type",
                            "id"
                        ],
                        "description": "Registro que asentó el movimiento; null si se cargó a mano."
                    },
                    "document": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "properties": {
                            "type": {
                                "type": "string",
                                "enum": [
                                    "order",
                                    "dispute",
                                    "pos_shift",
                                    "pos_safe",
                                    "purchase_order",
                                    "supplier_bill",
                                    "supplier_return",
                                    "payroll",
                                    "statement_import",
                                    "money_accounts"
                                ],
                                "description": "Tipo de comprobante: order — pedido; pos_shift — turno de caja; supplier_bill — factura de proveedor; purchase_order — orden de compra; supplier_return — devolución al proveedor; dispute — reclamo; payroll — período de sueldos; pos_safe — caja fuerte; statement_import — importación de extracto; money_accounts — saldo inicial de la cuenta."
                            },
                            "id": {
                                "type": [
                                    "integer",
                                    "null"
                                ],
                                "description": "ID del comprobante; null en los registros sin entrada propia: pos_safe, statement_import, money_accounts."
                            }
                        },
                        "required": [
                            "type",
                            "id"
                        ],
                        "description": "Comprobante principal del movimiento; null si se cargó a mano o el comprobante está en los libros de otra tienda del grupo."
                    },
                    "description": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Comentario del movimiento como lo escribió una persona o un documento; null si no hay."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo se creó el registro."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo cambió el registro por última vez."
                    }
                },
                "required": [
                    "id",
                    "version",
                    "account_id",
                    "direction",
                    "amount",
                    "currency",
                    "account_amount",
                    "account_currency",
                    "exchange_rate",
                    "occurred_at",
                    "occurred_on",
                    "category_id",
                    "supplier_id",
                    "transfer_id",
                    "reverses_transaction_id",
                    "origin",
                    "source",
                    "document",
                    "description",
                    "created_at",
                    "updated_at"
                ]
            },
            "MoneyTransactionDirection": {
                "type": "string",
                "enum": [
                    "income",
                    "expense"
                ]
            },
            "MoneyTransfer": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID de la transferencia: el transfer_id de sus partes en el libro de movimientos de dinero (/v1/money-transactions)."
                    },
                    "version": {
                        "type": "integer",
                        "description": "Versión del registro: crece con cada cambio. Para cambiar el registro, envíela como ETag en If-Match."
                    },
                    "from_account_id": {
                        "type": "integer",
                        "description": "ID de la cuenta de dinero de la que salió el dinero."
                    },
                    "to_account_id": {
                        "type": "integer",
                        "description": "ID de la cuenta de dinero a la que entró el dinero."
                    },
                    "from_amount": {
                        "type": "string",
                        "description": "Importe que salió de from_account_id en su moneda, como cadena decimal."
                    },
                    "from_currency": {
                        "type": "string",
                        "description": "Moneda de la cuenta de origen: código ISO 4217 o código de la criptomoneda."
                    },
                    "to_amount": {
                        "type": "string",
                        "description": "Importe que entró en to_account_id en su moneda, como cadena decimal. En la misma moneda es igual a from_amount: la diferencia es la comisión fee."
                    },
                    "to_currency": {
                        "type": "string",
                        "description": "Moneda de la cuenta de destino."
                    },
                    "fee": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Comisión de la transferencia en la moneda de la cuenta de origen, como cadena decimal: un egreso en la categoría de sistema bank_fees; null si no hay comisión."
                    },
                    "amount": {
                        "type": "integer",
                        "description": "Valor de la transferencia en unidades mínimas de la moneda de la tienda: lo llevan las dos partes. La diferencia de cambio de un canje de monedas el libro la asienta como movimiento aparte."
                    },
                    "currency": {
                        "type": "string",
                        "description": "Moneda de los importes, código ISO 4217: la moneda de la tienda."
                    },
                    "occurred_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Momento de la transferencia."
                    },
                    "occurred_on": {
                        "type": "string",
                        "format": "date",
                        "description": "Fecha contable de la transferencia, YYYY-MM-DD en la zona horaria de la tienda."
                    },
                    "description": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Descripción de la transferencia; null si no se cargó."
                    },
                    "from_transaction_id": {
                        "type": "integer",
                        "description": "ID del movimiento de egreso en la cuenta de origen."
                    },
                    "to_transaction_id": {
                        "type": "integer",
                        "description": "ID del movimiento de ingreso en la cuenta de destino."
                    },
                    "fee_transaction_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID del movimiento de la comisión; null si no hay comisión."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo se creó el registro."
                    }
                },
                "required": [
                    "id",
                    "version",
                    "from_account_id",
                    "to_account_id",
                    "from_amount",
                    "from_currency",
                    "to_amount",
                    "to_currency",
                    "fee",
                    "amount",
                    "currency",
                    "occurred_at",
                    "occurred_on",
                    "description",
                    "from_transaction_id",
                    "to_transaction_id",
                    "fee_transaction_id",
                    "created_at"
                ]
            },
            "Order": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID del registro, único entre los registros de su tipo en la tienda."
                    },
                    "number": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Número del pedido que ven el cliente y el personal; null mientras el pedido aún no lo tiene."
                    },
                    "channel": {
                        "type": "string",
                        "enum": [
                            "web",
                            "pos",
                            "marketplace",
                            "external",
                            "manual",
                            "subscription"
                        ],
                        "description": "De dónde vino el pedido: web — la tienda online; pos — la caja; marketplace — un marketplace como Mercado Libre; external — un sistema de gestión de la tienda; manual — un borrador de pedido del personal o de una aplicación; subscription — un día de un plan de comidas."
                    },
                    "app_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "La aplicación que confirmó el pedido desde su borrador (/v1/draft-orders), su id de /v1/me; null en los pedidos de la tienda online, la caja o el personal."
                    },
                    "location_id": {
                        "type": "integer",
                        "description": "Local que atiende el pedido: el punto de retiro o el local del que se descuenta el stock."
                    },
                    "legal_entity_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Razón social a nombre de la que se hizo la venta (/v1/legal-entities); null — la venta no está repartida entre razones sociales, y su razón social es la predeterminada de la tienda."
                    },
                    "status": {
                        "type": "string",
                        "description": "Estado del pedido: un código de la lista de estados de la tienda (/v1/order-statuses). La tienda puede agregar sus propios estados; status_group da el significado permanente."
                    },
                    "status_group": {
                        "type": "string",
                        "enum": [
                            "pos_open",
                            "placed",
                            "pending_payment",
                            "paid",
                            "confirmed",
                            "preparing",
                            "ready",
                            "ready_for_pickup",
                            "out_for_delivery",
                            "delivery_failed",
                            "delivered",
                            "completed",
                            "cancelled",
                            "refunded"
                        ],
                        "description": "Significado permanente del estado: pos_open — cuenta abierta en la caja; placed — realizado; pending_payment — esperando el pago; paid — pagado; confirmed — aceptado por la tienda; preparing — en preparación; ready — listo; ready_for_pickup — listo para retirar; out_for_delivery — en camino; delivery_failed — entrega fallida; delivered — entregado; completed — completado; cancelled — cancelado; refunded — reembolsado."
                    },
                    "payment_status": {
                        "type": "string",
                        "enum": [
                            "unpaid",
                            "partial",
                            "paid",
                            "partially_refunded",
                            "refunded"
                        ],
                        "description": "Pago del pedido: unpaid — sin pagar; partial — pagado en parte; paid — pagado; partially_refunded — reembolsado en parte; refunded — reembolsado."
                    },
                    "sale_type": {
                        "type": "string",
                        "enum": [
                            "retail",
                            "staff",
                            "wholesale"
                        ],
                        "description": "retail — venta a un cliente; staff — venta a un empleado; wholesale — venta mayorista."
                    },
                    "currency": {
                        "type": "string",
                        "description": "Moneda de los importes, código ISO 4217: la moneda de la tienda."
                    },
                    "items_total": {
                        "type": "integer",
                        "description": "Suma de los ítems antes del descuento del pedido."
                    },
                    "discount": {
                        "type": "integer",
                        "description": "Descuento del pedido sobre los productos: la suma de applied_discounts[].amount y de items[].discount."
                    },
                    "applied_discounts": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "id": {
                                    "type": "integer",
                                    "description": "Fila del registro; items[].discount_allocations[].applied_discount_id apunta a ella."
                                },
                                "source": {
                                    "type": "string",
                                    "enum": [
                                        "promocode",
                                        "automatic",
                                        "pick",
                                        "manual",
                                        "offline_capture",
                                        "loyalty_program",
                                        "external_pos"
                                    ],
                                    "description": "Cómo llegó el descuento al pedido: automatic — una regla de la tienda; pick — una regla que marcó el cajero; promocode — el código promocional del comprador; manual — un descuento manual del cajero; offline_capture — la diferencia entre una venta sin conexión de la caja y el cálculo del servidor, no una decisión del vendedor; loyalty_program — un programa de fidelización; external_pos — la caja externa que hizo la venta."
                                },
                                "kind": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "enum": [
                                        "promo",
                                        "employee",
                                        "expiry",
                                        "payment_method",
                                        "markdown",
                                        "goodwill",
                                        "comp",
                                        "other",
                                        null
                                    ],
                                    "description": "Por qué es el descuento: promo — una promoción; employee — para el personal; expiry — rebaja por vencimiento; payment_method — por el medio de pago; markdown — rebaja por el estado del producto; goodwill — una atención al comprador; comp — invita la casa; other — otro motivo. null — un descuento de la caja externa, una diferencia sin conexión o un descuento anterior a este eje."
                                },
                                "name": {
                                    "type": [
                                        "object",
                                        "null"
                                    ],
                                    "additionalProperties": true,
                                    "description": "Nombre de la regla o del programa de fidelización al momento de la venta; null en un código promocional, un descuento manual, una diferencia sin conexión y la caja externa."
                                },
                                "code": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "description": "El código promocional que ingresó el comprador; null — no es un descuento por código."
                                },
                                "reason": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "description": "El motivo del descuento manual en palabras del cajero; null en los demás."
                                },
                                "order_item_id": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "El ítem rebajado por separado; null — un descuento sobre el pedido, sus partes por ítem están en items[].discount_allocations."
                                },
                                "amount": {
                                    "type": "integer",
                                    "description": "Importe del descuento."
                                }
                            },
                            "required": [
                                "id",
                                "source",
                                "kind",
                                "name",
                                "code",
                                "reason",
                                "order_item_id",
                                "amount"
                            ]
                        },
                        "description": "De qué se compone el descuento sobre los productos: el registro de descuentos aplicados. Las filas se reescriben cuando se recalcula el pedido: un id vive hasta entonces."
                    },
                    "delivery_cost": {
                        "type": "integer",
                        "description": "Envío a pagar, después del descuento sobre el envío."
                    },
                    "delivery_discount": {
                        "type": "integer",
                        "description": "Descontado del envío: el precio del envío antes del descuento es delivery_cost + delivery_discount."
                    },
                    "delivery_discounts": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "id": {
                                    "type": "integer",
                                    "description": "Fila del registro de descuentos del envío."
                                },
                                "source": {
                                    "type": "string",
                                    "enum": [
                                        "promocode",
                                        "automatic",
                                        "pick",
                                        "manual",
                                        "offline_capture",
                                        "loyalty_program",
                                        "external_pos"
                                    ],
                                    "description": "Cómo llegó el descuento al pedido: los valores de applied_discounts[].source."
                                },
                                "kind": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "enum": [
                                        "promo",
                                        "employee",
                                        "expiry",
                                        "payment_method",
                                        "markdown",
                                        "goodwill",
                                        "comp",
                                        "other",
                                        null
                                    ],
                                    "description": "Por qué es el descuento: los valores de applied_discounts[].kind."
                                },
                                "name": {
                                    "type": [
                                        "object",
                                        "null"
                                    ],
                                    "additionalProperties": true,
                                    "description": "Nombre de la regla al momento de la venta; null — un descuento por código promocional."
                                },
                                "code": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "description": "El código promocional que ingresó el comprador; null — no es un descuento por código."
                                },
                                "amount": {
                                    "type": "integer",
                                    "description": "Importe del descuento sobre el envío."
                                }
                            },
                            "required": [
                                "id",
                                "source",
                                "kind",
                                "name",
                                "code",
                                "amount"
                            ]
                        },
                        "description": "De qué se compone el descuento sobre el envío: la suma de amount es igual a delivery_discount."
                    },
                    "delivery_tax_lines": {
                        "type": [
                            "array",
                            "null"
                        ],
                        "items": {
                            "$ref": "#/components/schemas/TaxLine"
                        },
                        "description": "Impuesto del envío según la clase impositiva predeterminada de la tienda: su parte del impuesto de su alícuota en tax_lines; null cuando no hay envío a pagar o el impuesto es desconocido."
                    },
                    "platform_discount": {
                        "type": "integer",
                        "description": "Descuento que paga la plataforma agregadora: no reduce la venta de la tienda."
                    },
                    "platform_service_fee": {
                        "type": "integer",
                        "description": "Tarifa de servicio de la plataforma agregadora: forma parte de total, pero no es venta de la tienda."
                    },
                    "platform_delivery_fee": {
                        "type": "integer",
                        "description": "Envío que hace la plataforma agregadora: forma parte de total, pero no es venta de la tienda."
                    },
                    "total": {
                        "type": "integer",
                        "description": "Importe del pedido a pagar."
                    },
                    "tax_lines": {
                        "type": [
                            "array",
                            "null"
                        ],
                        "items": {
                            "$ref": "#/components/schemas/TaxLine"
                        },
                        "description": "Impuesto de la venta según la clasificación de los productos al momento de la venta: la parte gravable del pedido (ítems salvo ventas de tarjetas de regalo, visitas por encima de lo pagado con un paquete, envío) por alícuota. Para cada alícuota, los tax_lines de los ítems y delivery_tax_lines suman la línea del pedido. El impuesto con valor legal está en el comprobante fiscal: lo define la entidad legal emisora según su condición fiscal. null cuando la tienda no tiene clases impositivas o el pedido no tiene parte gravable."
                    },
                    "gift_card_issue_amount": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Valor de la tarjeta de regalo que vende el pedido: una obligación de la tienda, no un ingreso; null si el pedido no vende una tarjeta."
                    },
                    "reservation_deposit_amount": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Seña de una reserva de mesa o de un turno: un pago anticipado, no un ingreso; null si el pedido no es una seña."
                    },
                    "account_payment_amount": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Pago de la deuda del cliente: dinero a cuenta de la deuda, no un ingreso; null si el pedido no es un pago de deuda."
                    },
                    "service_package_issue_amount": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Paquetes de visitas vendidos en el pedido: la tienda debe esas visitas, así que no es un ingreso — el ingreso llega cuando se usa una visita del paquete; null si el pedido no tiene paquetes."
                    },
                    "payment_method": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "enum": [
                            "cash",
                            "mercadopago",
                            "crypto",
                            "bybit",
                            "trc20",
                            "balance",
                            "modo",
                            "payway",
                            "mercadopago_qr",
                            "mercadopago_point",
                            "mercadopago_transfer",
                            "gift_card",
                            "subscription",
                            "deposit",
                            "external",
                            "manual",
                            "offset",
                            "on_account",
                            "exchange_credit",
                            "bonpunto",
                            "service_package",
                            null
                        ],
                        "description": "Medio de pago elegido al confirmar el pedido: manual — un medio manual de la tienda (manual_payment_method_id). Los pagos reales están en /v1/payments. null si no se eligió."
                    },
                    "manual_payment_method_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Medio de pago manual de la tienda (/v1/manual-payment-methods) cuando payment_method es manual; si no, null."
                    },
                    "delivery_method_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Método de envío de la tienda (/v1/delivery-methods); null si el pedido no tiene, como una venta en la caja."
                    },
                    "fulfilment_type": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "enum": [
                            "self_pickup",
                            "home_delivery",
                            "parcel_locker",
                            "mail_post",
                            "pos",
                            "aggregator",
                            "manual_courier",
                            null
                        ],
                        "description": "Cómo llega el pedido al cliente, según su método de envío al momento del pedido: self_pickup — retiro en un local; home_delivery — envío a domicilio; parcel_locker — un locker; mail_post — por correo; pos — entrega en la caja; aggregator — envío de una plataforma agregadora; manual_courier — un cadete que la tienda consigue por su cuenta. null si se desconoce."
                    },
                    "delivery_slots": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "from": {
                                    "type": "string",
                                    "description": "Inicio de la franja."
                                },
                                "to": {
                                    "type": "string",
                                    "description": "Fin de la franja."
                                }
                            },
                            "required": [
                                "from",
                                "to"
                            ]
                        },
                        "description": "Franjas de entrega elegidas por el cliente, por inicio; vacío si no hay franja."
                    },
                    "shipment": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "properties": {
                            "carrier": {
                                "type": "string",
                                "enum": [
                                    "andreani",
                                    "correo_argentino",
                                    "uber_direct",
                                    "mercadolibre",
                                    "courier_service"
                                ],
                                "description": "El transportista como clave de módulo: andreani, correo_argentino, uber_direct, mercadolibre (Mercado Envíos); courier_service — un servicio de envíos sin integración cuyo número cargó la tienda (POST /v1/orders/{order}/shipment/tracking), el servicio está en carrier_name, sin estados."
                            },
                            "carrier_name": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "description": "El servicio tal como lo nombró la tienda, en un número cargado a mano; null con un transportista integrado (lo nombra carrier) o si la tienda no nombró el servicio."
                            },
                            "tracking_number": {
                                "type": "string",
                                "description": "El número del envío en el transportista: con él se lo busca en la cuenta del transportista y se lo sigue."
                            },
                            "tracking_url": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "description": "La página de seguimiento del transportista; null si no la dio."
                            },
                            "status": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "enum": [
                                    "accepted",
                                    "preparing",
                                    "courier_assigned",
                                    "picked_up",
                                    "in_transit",
                                    "arrived_at_branch",
                                    "out_for_delivery",
                                    "delivery_failed",
                                    "delivered",
                                    "not_delivered",
                                    "returned",
                                    "lost",
                                    "cancelled",
                                    "unknown",
                                    null
                                ],
                                "description": "El último estado: accepted — aceptado, el paquete sigue en la tienda; preparing — el transportista prepara el despacho; courier_assigned — un repartidor va a retirarlo; picked_up — retirado; in_transit — en tránsito; arrived_at_branch — espera en una sucursal; out_for_delivery — con el repartidor de última milla; delivery_failed — falló un intento de entrega, el transportista lo reintentará; delivered — entregado; not_delivered — el transportista desistió de entregarlo; returned — devuelto al remitente; lost — perdido; cancelled — cancelado; unknown — un estado del transportista fuera de este conjunto, su texto está en events[].description. null si todavía no hay estado. Un estado intermedio tardío no deshace delivered, cancelled, returned ni lost."
                            },
                            "status_at": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "format": "date-time",
                                "description": "Cuándo ocurrió el último estado."
                            },
                            "events": {
                                "type": "array",
                                "items": {
                                    "type": "object",
                                    "properties": {
                                        "status": {
                                            "type": "string",
                                            "enum": [
                                                "accepted",
                                                "preparing",
                                                "courier_assigned",
                                                "picked_up",
                                                "in_transit",
                                                "arrived_at_branch",
                                                "out_for_delivery",
                                                "delivery_failed",
                                                "delivered",
                                                "not_delivered",
                                                "returned",
                                                "lost",
                                                "cancelled",
                                                "unknown"
                                            ],
                                            "description": "El estado — valores como en shipment.status."
                                        },
                                        "description": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "El estado en palabras del transportista; null si no dio texto."
                                        },
                                        "occurred_at": {
                                            "type": "string",
                                            "format": "date-time",
                                            "description": "Cuándo ocurrió el evento en el transportista."
                                        }
                                    },
                                    "required": [
                                        "status",
                                        "description",
                                        "occurred_at"
                                    ]
                                },
                                "description": "Historial de estados según el momento del evento en el transportista."
                            },
                            "label_available": {
                                "type": "boolean",
                                "description": "La etiqueta se puede descargar: la tienda tiene el archivo o el transportista la entrega a pedido."
                            }
                        },
                        "required": [
                            "carrier",
                            "carrier_name",
                            "tracking_number",
                            "tracking_url",
                            "status",
                            "status_at",
                            "events",
                            "label_available"
                        ],
                        "description": "El envío con el transportista, o el número de un servicio de envíos sin integración que cargó la tienda; null si el pedido no tiene. La etiqueta está en GET /v1/orders/{order}/shipment/label cuando label_available es true."
                    },
                    "previous_shipments": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "carrier": {
                                    "type": "string",
                                    "enum": [
                                        "andreani",
                                        "correo_argentino",
                                        "uber_direct",
                                        "mercadolibre",
                                        "courier_service"
                                    ],
                                    "description": "El transportista — valores como en shipment.carrier."
                                },
                                "carrier_name": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "description": "El servicio de un número cargado a mano — como en shipment.carrier_name."
                                },
                                "tracking_number": {
                                    "type": "string",
                                    "description": "El número del envío en el transportista."
                                },
                                "tracking_url": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "description": "La página de seguimiento del transportista; null si no la dio."
                                },
                                "status": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "enum": [
                                        "accepted",
                                        "preparing",
                                        "courier_assigned",
                                        "picked_up",
                                        "in_transit",
                                        "arrived_at_branch",
                                        "out_for_delivery",
                                        "delivery_failed",
                                        "delivered",
                                        "not_delivered",
                                        "returned",
                                        "lost",
                                        "cancelled",
                                        "unknown",
                                        null
                                    ],
                                    "description": "El último estado — valores como en shipment.status."
                                },
                                "status_at": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "format": "date-time",
                                    "description": "Cuándo ocurrió el último estado."
                                },
                                "events": {
                                    "type": "array",
                                    "items": {
                                        "type": "object",
                                        "properties": {
                                            "status": {
                                                "type": "string",
                                                "enum": [
                                                    "accepted",
                                                    "preparing",
                                                    "courier_assigned",
                                                    "picked_up",
                                                    "in_transit",
                                                    "arrived_at_branch",
                                                    "out_for_delivery",
                                                    "delivery_failed",
                                                    "delivered",
                                                    "not_delivered",
                                                    "returned",
                                                    "lost",
                                                    "cancelled",
                                                    "unknown"
                                                ],
                                                "description": "El estado — valores como en shipment.status."
                                            },
                                            "description": {
                                                "type": [
                                                    "string",
                                                    "null"
                                                ],
                                                "description": "El estado en palabras del transportista; null si no dio texto."
                                            },
                                            "occurred_at": {
                                                "type": "string",
                                                "format": "date-time",
                                                "description": "Cuándo ocurrió el evento en el transportista."
                                            }
                                        },
                                        "required": [
                                            "status",
                                            "description",
                                            "occurred_at"
                                        ]
                                    },
                                    "description": "Historial de estados según el momento del evento en el transportista."
                                }
                            },
                            "required": [
                                "carrier",
                                "carrier_name",
                                "tracking_number",
                                "tracking_url",
                                "status",
                                "status_at",
                                "events"
                            ]
                        },
                        "description": "Envíos reemplazados por una reemisión (se canceló el anterior y se emitió uno nuevo), del más antiguo al más nuevo; misma forma que shipment, sin label_available."
                    },
                    "shipment_attempt": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "properties": {
                            "state": {
                                "type": "string",
                                "enum": [
                                    "queued",
                                    "in_progress",
                                    "outcome_unknown",
                                    "failed"
                                ],
                                "description": "queued — la emisión se solicitó por la API y espera en la cola; in_progress — la solicitud al transportista está en curso; outcome_unknown — la conexión con el transportista se cortó después de la solicitud y no se sabe si el envío se creó: una nueva emisión queda bloqueada hasta que la tienda lo verifique con el transportista en el panel; failed — la emisión solicitada falló y no hay envío, el motivo está en error."
                            },
                            "started_at": {
                                "type": "string",
                                "format": "date-time",
                                "description": "Cuándo se solicitó o empezó la emisión."
                            },
                            "error": {
                                "type": [
                                    "object",
                                    "null"
                                ],
                                "properties": {
                                    "code": {
                                        "type": "string",
                                        "enum": [
                                            "no_carrier",
                                            "not_shippable",
                                            "awaits_bill_payment",
                                            "carrier_rejected",
                                            "shipment_data_invalid",
                                            "request_expired",
                                            "internal_error"
                                        ],
                                        "description": "El motivo como código: no_carrier — el método de entrega no tiene transportista integrado; not_shippable — el pedido ya no se despacha; awaits_bill_payment — la factura está impaga; carrier_rejected — el transportista la rechazó; shipment_data_invalid — faltan datos del pedido o de la configuración del transportista; request_expired — la solicitud no se procesó a tiempo; internal_error — una falla del servicio antes de contactar al transportista."
                                    },
                                    "message": {
                                        "type": "string",
                                        "description": "El motivo con las palabras de la tienda en el idioma de la respuesta; si lo rechazó el transportista, con sus palabras."
                                    }
                                },
                                "required": [
                                    "code",
                                    "message"
                                ],
                                "description": "Por qué falló la emisión solicitada; null si no falló."
                            }
                        },
                        "required": [
                            "state",
                            "started_at",
                            "error"
                        ],
                        "description": "Una emisión de envío sin cerrar; null si no hay."
                    },
                    "merged_into_order_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "El pedido en el que se fusionó este al unir las cuentas de una mesa: sus ítems y pagos están allí, y este queda como registro vacío cancelado. null si no se fusionó."
                    },
                    "cancel_reason": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "enum": [
                            "payment_init_failed",
                            "payment_declined",
                            "cashier_void",
                            "shift_closed",
                            "order_timeout",
                            "merged",
                            "items_moved",
                            "sale_void",
                            "subscription_day_unserved",
                            "booking_forfeit_reverted",
                            "service_package_term_extended",
                            "membership_renewal_void",
                            null
                        ],
                        "description": "Motivo de cancelación del sistema: payment_init_failed — el pago no pudo iniciarse; payment_declined — el pago fue rechazado; cashier_void — anulado en la caja; shift_closed — se cerró el turno de la caja; order_timeout — no se pagó a tiempo; merged — fusionado en otro pedido; items_moved — los ítems pasaron a otro pedido; sale_void — la venta se anuló; subscription_day_unserved — un día del plan no se sirvió; booking_forfeit_reverted — se revirtió la retención de una reserva; service_package_term_extended — se extendió un paquete de visitas y se revirtió su vencimiento; membership_renewal_void — se anuló la factura de renovación de una membresía: se canceló o terminó. null si no se canceló o si una persona dio el motivo."
                    },
                    "items": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "id": {
                                    "type": "integer",
                                    "description": "ID del ítem."
                                },
                                "variant_id": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "Variante del ítem; null en un ítem sin variante, como una tarjeta de regalo vendida en la caja."
                                },
                                "product_id": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "Producto del ítem; null en un ítem sin variante."
                                },
                                "product_name": {
                                    "type": "object",
                                    "additionalProperties": {
                                        "type": "string"
                                    },
                                    "description": "Nombre del producto al momento de la venta, por idioma."
                                },
                                "variant_name": {
                                    "type": "object",
                                    "additionalProperties": {
                                        "type": "string"
                                    },
                                    "description": "Nombre de la variante al momento de la venta, por idioma; un objeto vacío si la variante no tenía nombre."
                                },
                                "quantity": {
                                    "type": "string",
                                    "description": "Cantidad como cadena decimal en unit: unidades en un ítem por unidad, la medida en un ítem por peso o volumen (\"480\" gramos)."
                                },
                                "unit": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "enum": [
                                        "pcs",
                                        "g",
                                        "ml",
                                        null
                                    ],
                                    "description": "Unidad de quantity: pcs, g o ml; null si la variante ya no conoce la unidad de su medida."
                                },
                                "unit_price": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "Precio de una unidad; null en un ítem por peso o volumen, su importe está en total."
                                },
                                "total": {
                                    "type": "integer",
                                    "description": "Importe del ítem."
                                },
                                "discount": {
                                    "type": "integer",
                                    "description": "Descuento sobre el ítem."
                                },
                                "discount_allocations": {
                                    "type": "array",
                                    "items": {
                                        "type": "object",
                                        "properties": {
                                            "applied_discount_id": {
                                                "type": "integer",
                                                "description": "Fila de applied_discounts de este pedido."
                                            },
                                            "amount": {
                                                "type": "integer",
                                                "description": "La parte de este descuento en el ítem."
                                            }
                                        },
                                        "required": [
                                            "applied_discount_id",
                                            "amount"
                                        ]
                                    },
                                    "description": "De qué descuentos del registro se compone el descuento del ítem: la suma de amount es igual a items[].discount."
                                },
                                "is_gift": {
                                    "type": "boolean",
                                    "description": "Regalo de una promoción o un cupón: el ítem tiene precio y un descuento del 100 %."
                                },
                                "tax_lines": {
                                    "type": [
                                        "array",
                                        "null"
                                    ],
                                    "items": {
                                        "$ref": "#/components/schemas/TaxLine"
                                    },
                                    "description": "Impuesto del ítem: su parte del impuesto de su alícuota en tax_lines del pedido. Cubre la parte gravable del ítem: una visita pagada en parte con un paquete cuenta solo el resto. null para un ítem fuera de la venta (venta de una tarjeta de regalo, visita pagada por completo con un paquete, ítem con descuento total) o cuando el impuesto es desconocido."
                                },
                                "cost_amount": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "Costo del ítem al momento de la venta: un importe en unidades mínimas de currency por el ítem entero, no una tasa. null cuando no se calculó. Solo con el scope costs:read."
                                },
                                "cost_basis": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "enum": [
                                        "variant",
                                        "recipe",
                                        "unknown",
                                        "backfill",
                                        "standard",
                                        "partial",
                                        "external",
                                        null
                                    ],
                                    "description": "Cómo se calculó el costo: variant — el costo de la variante; recipe — la suma de la receta; standard — por la receta estándar, una estimación; partial — solo la parte conocida de la receta, un piso; backfill — estimado después por el costo del catálogo, no al momento de la venta; external — tomado de la caja externa que hizo la venta; unknown — no hay de qué calcularlo. Solo con el scope costs:read."
                                }
                            },
                            "required": [
                                "id",
                                "variant_id",
                                "product_id",
                                "product_name",
                                "variant_name",
                                "quantity",
                                "unit",
                                "unit_price",
                                "total",
                                "discount",
                                "discount_allocations",
                                "is_gift",
                                "tax_lines"
                            ]
                        },
                        "description": "Ítems del pedido: un registro histórico, los nombres son los del momento de la venta."
                    },
                    "customer": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "properties": {
                            "id": {
                                "type": "integer",
                                "description": "ID del registro, único entre los registros de su tipo en la tienda."
                            },
                            "name": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "description": "Nombre del cliente; null si se desconoce."
                            },
                            "phone": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "description": "Teléfono principal del cliente en formato E.164, por ejemplo +5491123456789; null si se desconoce."
                            },
                            "email": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "description": "Email del cliente; null si se desconoce."
                            }
                        },
                        "required": [
                            "id",
                            "name",
                            "phone",
                            "email"
                        ],
                        "description": "El cliente del pedido; null en un pedido sin cliente. Solo con el scope customers:read."
                    },
                    "delivery_address": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "properties": {
                            "kind": {
                                "type": "string",
                                "enum": [
                                    "address",
                                    "branch"
                                ],
                                "description": "address — una dirección del cliente; branch — una sucursal de retiro del transportista (branch, address_line)."
                            },
                            "recipient": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "description": "Quién recibe el pedido; null si no se indicó."
                            },
                            "phone": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "description": "Teléfono de quien recibe; null si no se indicó."
                            },
                            "street": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "description": "Calle."
                            },
                            "house": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "description": "Número de la calle."
                            },
                            "apartment": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "description": "Departamento u oficina."
                            },
                            "floor": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "description": "Piso."
                            },
                            "entrance": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "description": "Entrada."
                            },
                            "district": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "description": "Barrio."
                            },
                            "city": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "description": "Ciudad."
                            },
                            "province": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "description": "Provincia o estado."
                            },
                            "postal_code": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "description": "Código postal."
                            },
                            "address_line": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "description": "Dirección de la sucursal del transportista en una línea; null en una dirección del cliente."
                            },
                            "comment": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "description": "Comentario del cliente sobre la dirección, como la forma de entrar."
                            },
                            "location": {
                                "type": [
                                    "object",
                                    "null"
                                ],
                                "properties": {
                                    "lat": {
                                        "type": "number",
                                        "description": "Latitud en grados."
                                    },
                                    "lng": {
                                        "type": "number",
                                        "description": "Longitud en grados."
                                    }
                                },
                                "required": [
                                    "lat",
                                    "lng"
                                ],
                                "description": "Ubicación de la dirección en el mapa; null si se desconoce."
                            },
                            "branch": {
                                "type": [
                                    "object",
                                    "null"
                                ],
                                "properties": {
                                    "external_id": {
                                        "type": [
                                            "string",
                                            "null"
                                        ],
                                        "description": "ID de la sucursal en el sistema del transportista."
                                    },
                                    "name": {
                                        "type": [
                                            "string",
                                            "null"
                                        ],
                                        "description": "Nombre de la sucursal."
                                    }
                                },
                                "required": [
                                    "external_id",
                                    "name"
                                ],
                                "description": "La sucursal del transportista cuando kind es branch; si no, null."
                            }
                        },
                        "required": [
                            "kind",
                            "recipient",
                            "phone",
                            "street",
                            "house",
                            "apartment",
                            "floor",
                            "entrance",
                            "district",
                            "city",
                            "province",
                            "postal_code",
                            "address_line",
                            "comment",
                            "location",
                            "branch"
                        ],
                        "description": "Dirección de envío al momento del pedido; null en un retiro: el punto de retiro está en location_id. Solo con el scope customers:read."
                    },
                    "customer_comment": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Comentario del cliente al pedido. Solo con el scope customers:read."
                    },
                    "fiscal_receptor": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "properties": {
                            "id_type": {
                                "type": "string",
                                "enum": [
                                    "tax_id",
                                    "personal_id",
                                    "national_id",
                                    "passport",
                                    "none"
                                ],
                                "description": "Tipo de identificación: tax_id — CUIT de una empresa; personal_id — CUIL de una persona; national_id — DNI; passport — pasaporte; none — sin identificación."
                            },
                            "id_number": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "description": "Número de la identificación; null cuando id_type es none."
                            },
                            "name": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "description": "Razón social o nombre completo para el comprobante; null si no se indicó."
                            },
                            "tax_status": {
                                "type": "string",
                                "enum": [
                                    "registered",
                                    "small_taxpayer",
                                    "exempt",
                                    "final_consumer",
                                    "not_categorized",
                                    "foreign"
                                ],
                                "description": "Condición frente al IVA: registered — Responsable Inscripto; small_taxpayer — Monotributo; exempt — exento; final_consumer — consumidor final; not_categorized — no categorizado; foreign — cliente del exterior."
                            },
                            "address": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "description": "Domicilio fiscal en una línea; null si no se indicó."
                            }
                        },
                        "required": [
                            "id_type",
                            "id_number",
                            "name",
                            "tax_status",
                            "address"
                        ],
                        "description": "A quién se emite el comprobante fiscal del pedido, fijado en el pedido; null en una venta minorista sin datos fiscales. Solo con el scope customers:read."
                    },
                    "external_fiscal_document": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "properties": {
                            "issuer": {
                                "type": "string",
                                "description": "La caja que emite el comprobante: fudo es FuDo, poster es Poster."
                            },
                            "status": {
                                "type": "string",
                                "enum": [
                                    "pending",
                                    "issued"
                                ],
                                "description": "pending: la cuenta está abierta en la caja, que emite el comprobante al cerrarla; issued: la caja emitió el comprobante."
                            },
                            "number": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "description": "Número del comprobante en la caja; null mientras no se emite o si la caja no informa el número."
                            }
                        },
                        "required": [
                            "issuer",
                            "status",
                            "number"
                        ],
                        "description": "El comprobante de la venta en una caja externa: el pedido fue a la caja de la tienda o vino de ella, y el comprobante lo emite la caja, no nosotros; ese pedido no tiene comprobantes fiscales. null si no hay comprobante de la caja: el comprobante es nuestro o la caja no lo informó. Solo con el scope fiscal:read."
                    },
                    "placed_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo se realizó el pedido."
                    },
                    "confirmed_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Cuándo la tienda confirmó el pedido; null hasta entonces."
                    },
                    "completed_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Cuándo se completó el pedido; null hasta entonces."
                    },
                    "cancelled_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Cuándo se canceló el pedido; null si no se canceló."
                    },
                    "refunded_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Cuándo se reembolsó el pedido por completo; null si no se reembolsó."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo se creó el registro."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo cambió el registro por última vez."
                    }
                },
                "required": [
                    "id",
                    "number",
                    "channel",
                    "app_id",
                    "location_id",
                    "legal_entity_id",
                    "status",
                    "status_group",
                    "payment_status",
                    "sale_type",
                    "currency",
                    "items_total",
                    "discount",
                    "applied_discounts",
                    "delivery_cost",
                    "delivery_discount",
                    "delivery_discounts",
                    "delivery_tax_lines",
                    "platform_discount",
                    "platform_service_fee",
                    "platform_delivery_fee",
                    "total",
                    "tax_lines",
                    "gift_card_issue_amount",
                    "reservation_deposit_amount",
                    "account_payment_amount",
                    "service_package_issue_amount",
                    "payment_method",
                    "manual_payment_method_id",
                    "delivery_method_id",
                    "fulfilment_type",
                    "delivery_slots",
                    "shipment",
                    "previous_shipments",
                    "shipment_attempt",
                    "merged_into_order_id",
                    "cancel_reason",
                    "items",
                    "placed_at",
                    "confirmed_at",
                    "completed_at",
                    "cancelled_at",
                    "refunded_at",
                    "created_at",
                    "updated_at"
                ]
            },
            "OrderStatus": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID del registro, único entre los registros de su tipo en la tienda."
                    },
                    "code": {
                        "type": "string",
                        "description": "Código del estado: el valor de status de un pedido. Los códigos de los estados del sistema son iguales en todas las tiendas."
                    },
                    "name": {
                        "type": "object",
                        "additionalProperties": {
                            "type": "string"
                        },
                        "description": "Nombre del estado por idioma, como lo muestra la tienda."
                    },
                    "status_group": {
                        "type": "string",
                        "enum": [
                            "pos_open",
                            "placed",
                            "pending_payment",
                            "paid",
                            "confirmed",
                            "preparing",
                            "ready",
                            "ready_for_pickup",
                            "out_for_delivery",
                            "delivery_failed",
                            "delivered",
                            "completed",
                            "cancelled",
                            "refunded"
                        ],
                        "description": "Significado permanente del estado, los mismos valores que status_group de un pedido."
                    },
                    "allowed_next": {
                        "type": "array",
                        "items": {
                            "type": "string"
                        },
                        "description": "Códigos de los estados a los que un pedido pasa desde este, según las reglas de transición de la tienda. El cambio también se verifica con el pedido: un retiro no pasa a un cadete, un envío necesita cadete, completar exige el pedido pagado."
                    },
                    "is_system": {
                        "type": "boolean",
                        "description": "Un estado del sistema: uno por cada significado de status_group, igual en todas las tiendas. Los estados que agrega la tienda tienen false."
                    },
                    "position": {
                        "type": "integer",
                        "description": "Posición en la lista de estados de la tienda."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo se creó el registro."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo cambió el registro por última vez."
                    },
                    "deleted_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Cuándo la tienda retiró el estado: los pedidos ya no pasan a él, los pedidos pasados lo siguen mostrando. null en un estado en uso."
                    }
                },
                "required": [
                    "id",
                    "code",
                    "name",
                    "status_group",
                    "allowed_next",
                    "is_system",
                    "position",
                    "created_at",
                    "updated_at",
                    "deleted_at"
                ]
            },
            "Payment": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID del registro, único entre los registros de su tipo en la tienda."
                    },
                    "order_id": {
                        "type": "integer",
                        "description": "ID del pedido."
                    },
                    "pos_shift_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID del turno de caja (/v1/pos-shifts) que recibió el dinero: el informe Z asigna el pago a ese turno. null — no es un pago de caja."
                    },
                    "legal_entity_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Razón social que recibe el dinero (/v1/legal-entities), la del pedido; null — la venta no está repartida entre razones sociales, y el dinero lo recibe la razón social predeterminada de la tienda."
                    },
                    "method": {
                        "type": "string",
                        "enum": [
                            "cash",
                            "mercadopago",
                            "crypto",
                            "bybit",
                            "trc20",
                            "balance",
                            "modo",
                            "payway",
                            "mercadopago_qr",
                            "mercadopago_point",
                            "mercadopago_transfer",
                            "gift_card",
                            "subscription",
                            "deposit",
                            "external",
                            "manual",
                            "offset",
                            "on_account",
                            "exchange_credit",
                            "bonpunto",
                            "service_package"
                        ],
                        "description": "Medio de pago. manual — un medio manual de la tienda (manual_payment_method_id); balance — el saldo del cliente; on_account — a cuenta, el cliente debe el importe; gift_card — una tarjeta de regalo; los demás valores nombran al proveedor de pagos o el tipo de pago."
                    },
                    "manual_payment_method_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Medio de pago manual de la tienda (/v1/manual-payment-methods) cuando method es manual; si no, null."
                    },
                    "status": {
                        "type": "string",
                        "enum": [
                            "pending",
                            "processing",
                            "succeeded",
                            "failed",
                            "partially_refunded",
                            "refunded",
                            "expired",
                            "voided"
                        ],
                        "description": "pending — esperando el dinero; processing — el proveedor lo procesa; succeeded — pagado; failed — fallido; partially_refunded — reembolsado en parte; refunded — reembolsado; expired — el link de pago venció; voided — anulado antes de que llegara el dinero."
                    },
                    "currency": {
                        "type": "string",
                        "description": "Moneda de los importes, código ISO 4217: la moneda de la tienda."
                    },
                    "amount": {
                        "type": "integer",
                        "description": "Importe a pagar con este pago."
                    },
                    "received_amount": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Importe realmente recibido; null mientras el dinero no llegó. Lo recibido por el pedido es received_amount menos refunded_amount de sus pagos."
                    },
                    "refunded_amount": {
                        "type": "integer",
                        "description": "Reembolsado de lo recibido."
                    },
                    "tip_amount": {
                        "type": "integer",
                        "description": "Propina por encima del importe del pedido."
                    },
                    "refunded_tip_amount": {
                        "type": "integer",
                        "description": "Reembolsado de la propina."
                    },
                    "surcharge_amount": {
                        "type": "integer",
                        "description": "Recargo por pagar en cuotas, por encima del importe del pedido."
                    },
                    "refunded_surcharge_amount": {
                        "type": "integer",
                        "description": "Reembolsado del recargo."
                    },
                    "provider_fee_amount": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Comisión que el proveedor de pagos descontó del pago antes de liquidarlo a la tienda. null — el proveedor no informa cargos: efectivo, medio manual o un pago que no se cobró."
                    },
                    "refunded_provider_fee_amount": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Parte de la comisión que el proveedor devolvió al reembolsar al comprador, según sus datos y no en proporción a refunded_amount: un reembolso por fuera del proveedor no devuelve la comisión."
                    },
                    "provider_withheld_tax_amount": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Impuesto que el proveedor retuvo del pago como agente de recaudación (Ingresos Brutos en MercadoPago). La retención con su jurisdicción está en el registro impositivo de la tienda."
                    },
                    "refunded_provider_withheld_tax_amount": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Parte del impuesto retenido que el proveedor devolvió."
                    },
                    "tender": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "properties": {
                            "currency": {
                                "type": "string",
                                "description": "Moneda del medio de pago: código ISO 4217 o código de un criptoactivo, por ejemplo USDT."
                            },
                            "amount": {
                                "type": "string",
                                "description": "Monto de la factura en la moneda del medio, como cadena decimal: cubre amount junto con la propina y el recargo. Multiplicado por la cotización puede no coincidir con amount por el redondeo y por la parte de la factura cotizada en la moneda del medio directamente desde la lista de precios."
                            },
                            "received_amount": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "description": "Recibido en la moneda del medio, como cadena decimal; null — lo recibido se lleva solo en la moneda de la tienda (received_amount) o llegó otra moneda (received_asset)."
                            },
                            "tendered_amount": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "description": "Efectivo en moneda extranjera: cuántos billetes se entregaron, como cadena decimal. El vuelto se da en la moneda de la tienda. null en los demás medios."
                            },
                            "exchange_rate": {
                                "type": [
                                    "object",
                                    "null"
                                ],
                                "properties": {
                                    "rate": {
                                        "type": "string",
                                        "description": "Cotización como cadena decimal: 1 unidad de la moneda del medio = rate unidades de la moneda de la tienda."
                                    },
                                    "mode": {
                                        "type": [
                                            "string",
                                            "null"
                                        ],
                                        "enum": [
                                            "auto",
                                            "fixed",
                                            "pegged",
                                            null
                                        ],
                                        "description": "Cómo se obtuvo la cotización: auto — la cotización de mercado de la fuente más el recargo de la tienda; fixed — la cotización fijada por la tienda; pegged — la tienda vinculó la moneda del medio a otra moneda (peg), y la cotización es la de esa moneda por el coeficiente de vinculación. null en facturas emitidas antes de las reglas de cotización."
                                    },
                                    "source": {
                                        "type": [
                                            "string",
                                            "null"
                                        ],
                                        "enum": [
                                            "coingecko",
                                            "criptoya_p2p",
                                            "ar_oficial",
                                            "ar_blue",
                                            "ar_mep",
                                            "ar_ccl",
                                            "ar_mayorista",
                                            "cbr",
                                            null
                                        ],
                                        "description": "Fuente de la cotización de mercado: coingecko — precio agregado de CoinGecko; criptoya_p2p — mediana de los mercados P2P; ar_oficial, ar_blue, ar_mep, ar_ccl, ar_mayorista — cotizaciones del dólar en Argentina; cbr — Banco de Rusia. null si no se registró la fuente."
                                    },
                                    "base": {
                                        "type": [
                                            "string",
                                            "null"
                                        ],
                                        "description": "Cotización de mercado de la fuente antes del recargo de la tienda, como cadena decimal; null si no hay base de mercado."
                                    },
                                    "markup_bps": {
                                        "type": [
                                            "integer",
                                            "null"
                                        ],
                                        "description": "Recargo de la tienda sobre la cotización de mercado en puntos básicos (100 es 1 %); puede ser negativo. null con una cotización fijada por la tienda y en facturas emitidas antes de las reglas de cotización."
                                    },
                                    "peg": {
                                        "type": [
                                            "object",
                                            "null"
                                        ],
                                        "properties": {
                                            "currency": {
                                                "type": "string",
                                                "description": "Moneda a la que está vinculada la moneda del medio (ISO 4217)."
                                            },
                                            "rate": {
                                                "type": "string",
                                                "description": "Coeficiente de vinculación como cadena decimal: cuántas unidades de peg.currency vale una unidad de la moneda del medio."
                                            }
                                        },
                                        "required": [
                                            "currency",
                                            "rate"
                                        ],
                                        "description": "Vinculación de la moneda del medio a otra moneda: 1 unidad de la moneda del medio = peg.rate unidades de peg.currency (por ejemplo, 1 USDT = 1 USD). Los precios fijados en esa moneda entran en la factura tal cual. null si la cotización no está vinculada."
                                    }
                                },
                                "required": [
                                    "rate",
                                    "mode",
                                    "source",
                                    "base",
                                    "markup_bps",
                                    "peg"
                                ],
                                "description": "Cotización con la que el monto en la moneda del medio pasó a ser el monto del pago, tomada al emitir el pago; null si no hay cotización."
                            }
                        },
                        "required": [
                            "currency",
                            "amount",
                            "received_amount",
                            "tendered_amount",
                            "exchange_rate"
                        ],
                        "description": "Pago en una moneda distinta de la de la tienda: una factura en USDT, una transferencia en dólares, efectivo en moneda extranjera. null — el pago es en la moneda de la tienda. Los montos del pago (amount y los demás) quedan en la moneda de la tienda, y la contabilidad se lleva con ellos."
                    },
                    "received_asset": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "properties": {
                            "asset": {
                                "type": "string",
                                "description": "Código de la moneda, por ejemplo USDC."
                            },
                            "amount": {
                                "type": "string",
                                "description": "Cuántas monedas llegaron, como cadena decimal."
                            },
                            "rate": {
                                "type": "string",
                                "description": "Cotización de acreditación como cadena decimal: 1 moneda = rate unidades de la moneda de la tienda."
                            },
                            "rate_source": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "description": "Fuente de la cotización de acreditación; manual — cotización cargada a mano."
                            },
                            "rate_as_of": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "description": "Momento de la cotización o de la versión de la cotización manual."
                            },
                            "tx_id": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "description": "ID de la transferencia en la blockchain o en el exchange, para conciliar."
                            }
                        },
                        "required": [
                            "asset",
                            "amount",
                            "rate",
                            "rate_source",
                            "rate_as_of",
                            "tx_id"
                        ],
                        "description": "Moneda que llegó de verdad cuando el comprador transfirió algo distinto de lo facturado y se la valuó aparte; null — llegó lo facturado."
                    },
                    "provider_payment_id": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "ID de la operación en el proveedor de pagos, para conciliar con su resumen; null si no hay proveedor."
                    },
                    "payment_url": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Página de pago del proveedor mientras el pago espera el dinero: el link se puede enviar al cliente. null en un pago pagado o anulado y en un medio manual."
                    },
                    "confirmable": {
                        "type": "boolean",
                        "description": "El pago se puede confirmar a mano ahora (POST /v1/payments/{payment}/confirm): espera dinero cuya llegada confirma una persona, no el proveedor."
                    },
                    "replaces_payment_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "El pago que este reemplazó al corregir el medio de pago; si no, null."
                    },
                    "confirmed_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Cuándo se recibió el dinero; null mientras no se recibió."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo se creó el registro."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo cambió el registro por última vez."
                    }
                },
                "required": [
                    "id",
                    "order_id",
                    "pos_shift_id",
                    "legal_entity_id",
                    "method",
                    "manual_payment_method_id",
                    "status",
                    "currency",
                    "amount",
                    "received_amount",
                    "refunded_amount",
                    "tip_amount",
                    "refunded_tip_amount",
                    "surcharge_amount",
                    "refunded_surcharge_amount",
                    "provider_fee_amount",
                    "refunded_provider_fee_amount",
                    "provider_withheld_tax_amount",
                    "refunded_provider_withheld_tax_amount",
                    "tender",
                    "received_asset",
                    "provider_payment_id",
                    "payment_url",
                    "confirmable",
                    "replaces_payment_id",
                    "confirmed_at",
                    "created_at",
                    "updated_at"
                ]
            },
            "PosCashMovement": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID del registro, único entre los registros de su tipo en la tienda."
                    },
                    "shift_id": {
                        "type": "integer",
                        "description": "ID del turno de caja (/v1/pos-shifts)."
                    },
                    "type": {
                        "type": "string",
                        "enum": [
                            "pay_in",
                            "pay_out",
                            "sale_cash_in",
                            "refund_cash_out",
                            "courier_shortage",
                            "waiter_cash_in",
                            "sale_reversal",
                            "no_sale",
                            "float_in",
                            "drop_out",
                            "pay_in_reversal",
                            "pay_out_reversal",
                            "drop_out_reversal",
                            "float_in_reversal",
                            "change_out",
                            "change_out_reversal"
                        ],
                        "description": "Tipo de movimiento: sale_cash_in — venta en efectivo; refund_cash_out — devolución en efectivo; sale_reversal — efectivo devuelto al deshacer una venta sin terminar; change_out — vuelto en moneda de la tienda por billetes en moneda extranjera; pay_in y pay_out — ingreso y retiro con motivo; drop_out — depósito en la caja fuerte; float_in — cambio desde la caja fuerte; waiter_cash_in — efectivo que entregó un mozo; courier_shortage — faltante del repartidor; no_sale — cajón abierto sin venta; *_reversal — anulaciones."
                    },
                    "direction": {
                        "type": "string",
                        "enum": [
                            "in",
                            "out",
                            "none"
                        ],
                        "description": "Signo en el esperado del cajón: in — el dinero entró al cajón; out — salió; none — se abrió el cajón sin dinero."
                    },
                    "amount": {
                        "type": "integer",
                        "description": "Importe en unidades mínimas de la moneda del movimiento, nunca negativo: el signo lo da direction."
                    },
                    "currency": {
                        "type": "string",
                        "enum": [
                            "ARS",
                            "USD",
                            "BRL",
                            "CLP",
                            "COP",
                            "MXN",
                            "PEN",
                            "RUB"
                        ],
                        "description": "Moneda del cajón que cambia el movimiento, código ISO 4217."
                    },
                    "occurred_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo ocurrió según la hora de la caja: un movimiento registrado sin conexión llega después."
                    },
                    "order_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID del pedido."
                    },
                    "payment_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID del pago (/v1/payments) de la venta o devolución en efectivo; null en los movimientos manuales."
                    },
                    "reverses_movement_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID del movimiento que este anula; null en un movimiento común."
                    },
                    "cash_transfer_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID del sobre de la caja fuerte — depósito o cambio: el libro de movimientos de dinero lo referencia con un source de tipo pos_cash_transfer. null si no hay sobre."
                    },
                    "cash_reason_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID del motivo de ingreso o retiro (/v1/pos-cash-reasons); null en los demás tipos."
                    },
                    "supplier_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID del proveedor al que se le pagó; null si el retiro no fue a un proveedor."
                    },
                    "comment": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Comentario del cajero; null si no hay."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo se creó el registro."
                    }
                },
                "required": [
                    "id",
                    "shift_id",
                    "type",
                    "direction",
                    "amount",
                    "currency",
                    "occurred_at",
                    "order_id",
                    "payment_id",
                    "reverses_movement_id",
                    "cash_transfer_id",
                    "cash_reason_id",
                    "supplier_id",
                    "comment",
                    "created_at"
                ]
            },
            "PosCashReason": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID del registro, único entre los registros de su tipo en la tienda."
                    },
                    "direction": {
                        "type": "string",
                        "enum": [
                            "pay_in",
                            "pay_out"
                        ],
                        "description": "pay_in — motivo de ingreso; pay_out — motivo de retiro."
                    },
                    "name": {
                        "type": "object",
                        "additionalProperties": {
                            "type": "string"
                        },
                        "description": "Nombre por idioma: un objeto con los idiomas completados, por ejemplo {\"es\": \"Café\", \"en\": \"Coffee\"}."
                    },
                    "system_code": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "enum": [
                            "other",
                            null
                        ],
                        "description": "Código del motivo del sistema: other — «Otros», uno por dirección. null en los motivos que creó la tienda."
                    },
                    "category_id": {
                        "type": "integer",
                        "description": "ID de la categoría del libro de movimientos de dinero (/v1/money-categories) en la que se asienta el movimiento con este motivo."
                    },
                    "position": {
                        "type": "integer",
                        "description": "Posición en el orden: la menor va primero."
                    },
                    "archived_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Cuándo se archivó el motivo: la caja ya no lo ofrece, el historial queda. null si está activo."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo se creó el registro."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo cambió el registro por última vez."
                    }
                },
                "required": [
                    "id",
                    "direction",
                    "name",
                    "system_code",
                    "category_id",
                    "position",
                    "archived_at",
                    "created_at",
                    "updated_at"
                ]
            },
            "PosShift": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID del registro, único entre los registros de su tipo en la tienda."
                    },
                    "number": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Número del turno en el registro de la caja, por ejemplo Z-0044; null en turnos anteriores a la numeración."
                    },
                    "location_id": {
                        "type": "integer",
                        "description": "ID del local de la tienda."
                    },
                    "register_id": {
                        "type": "integer",
                        "description": "ID de la caja del punto. La API no tiene catálogo de cajas: para la contabilidad, agrupá los turnos por punto."
                    },
                    "status": {
                        "type": "string",
                        "enum": [
                            "open",
                            "closed"
                        ],
                        "description": "open — el turno está en curso; closed — se contó el cajón y el turno se cerró."
                    },
                    "opened_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo se abrió el turno."
                    },
                    "closed_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Cuándo se cerró el turno; null mientras está abierto."
                    },
                    "notes": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Nota de quien cerró el turno; null si no hay."
                    },
                    "drawers": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "id": {
                                    "type": "integer",
                                    "description": "ID del cajón: la diferencia de un cajón en moneda extranjera se asienta en el libro de movimientos de dinero con un source de tipo pos_shift_drawer y este ID."
                                },
                                "currency": {
                                    "type": "string",
                                    "enum": [
                                        "ARS",
                                        "USD",
                                        "BRL",
                                        "CLP",
                                        "COP",
                                        "MXN",
                                        "PEN",
                                        "RUB"
                                    ],
                                    "description": "Moneda del cajón, código ISO 4217: los importes del cajón están en sus unidades mínimas."
                                },
                                "opening_float": {
                                    "type": "integer",
                                    "description": "Fondo inicial."
                                },
                                "expected": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "Cuánto debía haber en el cajón al cierre; null mientras el turno está abierto."
                                },
                                "counted": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "Cuánto se contó al cierre; null mientras el turno está abierto."
                                },
                                "difference": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "Diferencia: counted menos expected — sobrante con signo positivo, faltante con signo negativo. El libro de movimientos de dinero la asienta con el turno como comprobante. null mientras el turno está abierto."
                                },
                                "carried_float": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "Lo que quedó en el cajón como fondo del turno siguiente; lo depositado en la caja fuerte es counted menos carried_float. null mientras está abierto y en turnos cerrados antes de llevar la caja fuerte."
                                }
                            },
                            "required": [
                                "id",
                                "currency",
                                "opening_float",
                                "expected",
                                "counted",
                                "difference",
                                "carried_float"
                            ]
                        },
                        "description": "Un cajón por cada moneda que pasó por él; primero la moneda de la tienda. El esperado del cajón es opening_float más los movimientos de su moneda con el signo de direction."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo se creó el registro."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo cambió el registro por última vez."
                    }
                },
                "required": [
                    "id",
                    "number",
                    "location_id",
                    "register_id",
                    "status",
                    "opened_at",
                    "closed_at",
                    "notes",
                    "drawers",
                    "created_at",
                    "updated_at"
                ]
            },
            "PostSupplierBillCommandRequest": {
                "type": "object",
                "properties": []
            },
            "PriceList": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID del registro, único entre los registros de su tipo en la tienda."
                    },
                    "version": {
                        "type": "integer",
                        "description": "Versión del registro: crece con cada cambio. Para cambiar el registro, envíela como ETag en If-Match."
                    },
                    "kind": {
                        "type": "string",
                        "enum": [
                            "location",
                            "wholesale"
                        ],
                        "description": "Tipo de lista: location — precios de venta en los locales de la lista sobre el precio base, wholesale — precios mayoristas de un cliente empresa desde el costo. No cambia."
                    },
                    "name": {
                        "type": "string",
                        "description": "Etiqueta de la lista en el panel de la tienda; en una lista de local, el nombre del local para el que se creó."
                    },
                    "adjustment_bp": {
                        "type": "integer",
                        "description": "Ajuste de la regla en puntos básicos: +20 % es 2000, −10 % es -1000. En una lista de local se aplica al precio base de la variante (de -9000 a 50000); en una mayorista es el margen sobre el costo unitario (de 0 a 50000)."
                    },
                    "rounding": {
                        "type": "object",
                        "properties": {
                            "mode": {
                                "type": "string",
                                "enum": [
                                    "nearest",
                                    "up",
                                    "down"
                                ],
                                "description": "Sentido del redondeo: nearest — al más cercano, up — hacia arriba, down — hacia abajo."
                            },
                            "precision": {
                                "type": "integer",
                                "description": "Dígito de redondeo en decimales de la unidad mayor: 2 — a centavos, 0 — a unidades, -2 — a centenas."
                            }
                        },
                        "required": [
                            "mode",
                            "precision"
                        ],
                        "description": "Redondeo del precio que da la regla de la lista. Los precios fijos y los de ítems por peso o volumen no se redondean."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo se creó el registro."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo cambió el registro por última vez."
                    }
                },
                "required": [
                    "id",
                    "version",
                    "kind",
                    "name",
                    "adjustment_bp",
                    "rounding",
                    "created_at",
                    "updated_at"
                ]
            },
            "PriceListItem": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID del registro, único entre los registros de su tipo en la tienda."
                    },
                    "price_list_id": {
                        "type": "integer",
                        "description": "ID de la lista de precios."
                    },
                    "variant_id": {
                        "type": "integer",
                        "description": "ID de la variante con precio fijo en la lista; la variante puede estar archivada."
                    },
                    "price": {
                        "type": "integer",
                        "description": "Precio en unidades mínimas de currency: el precio fijado en la moneda de la tienda."
                    },
                    "compare_at_price": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Precio antes del descuento, que se muestra tachado; null si no hay descuento. En una lista mayorista siempre es null."
                    },
                    "list_price": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Precio tal como lo fijó el dueño, en unidades mínimas de list_price_currency; null — el precio se fijó en la moneda de la tienda (price)."
                    },
                    "list_compare_at_price": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Precio antes del descuento en list_price_currency; null — sin descuento o precio fijado en la moneda de la tienda."
                    },
                    "list_price_currency": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Moneda del precio fijado (lista de precios en otra moneda); null — el precio está en la moneda de la tienda."
                    },
                    "currency": {
                        "type": "string",
                        "description": "Moneda de los importes, código ISO 4217: la moneda de la tienda."
                    },
                    "tare_quantity": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Envase por el que se fija el precio mayorista de una materia prima o preparación, en la unidad de la variante, tal como era al fijarlo; null — el precio es por el price_per_quantity de la variante."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo se creó el registro."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo cambió el registro por última vez."
                    }
                },
                "required": [
                    "id",
                    "price_list_id",
                    "variant_id",
                    "price",
                    "compare_at_price",
                    "list_price",
                    "list_compare_at_price",
                    "list_price_currency",
                    "currency",
                    "tare_quantity",
                    "created_at",
                    "updated_at"
                ]
            },
            "PriceListModifierItem": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID del registro, único entre los registros de su tipo en la tienda."
                    },
                    "price_list_id": {
                        "type": "integer",
                        "description": "ID de la lista de precios."
                    },
                    "modifier_option_id": {
                        "type": "integer",
                        "description": "ID de la opción del modificador."
                    },
                    "variant_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Variante del ítem para la que el recargo es propio; null — el recargo vale para todas las variantes."
                    },
                    "price_delta": {
                        "type": "integer",
                        "description": "Recargo de la opción en unidades mínimas de currency: el recargo fijado en la moneda de la tienda."
                    },
                    "list_price_delta": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Recargo tal como lo fijó el dueño, en unidades mínimas de list_price_currency; null — se fijó en la moneda de la tienda (price_delta)."
                    },
                    "list_price_currency": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Moneda del recargo fijado; null — el recargo está en la moneda de la tienda."
                    },
                    "currency": {
                        "type": "string",
                        "description": "Moneda de los importes, código ISO 4217: la moneda de la tienda."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo se creó el registro."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo cambió el registro por última vez."
                    }
                },
                "required": [
                    "id",
                    "price_list_id",
                    "modifier_option_id",
                    "variant_id",
                    "price_delta",
                    "list_price_delta",
                    "list_price_currency",
                    "currency",
                    "created_at",
                    "updated_at"
                ]
            },
            "Problem": {
                "type": "object",
                "properties": {
                    "type": {
                        "type": "string",
                        "description": "Tipo técnico del problema: un código estable para decidir qué hacer, como insufficient_scope. Cada tipo tiene una página en el catálogo de errores."
                    },
                    "title": {
                        "type": "string",
                        "description": "Resumen breve del problema en el idioma de la solicitud."
                    },
                    "status": {
                        "type": "integer",
                        "description": "Estado HTTP de la respuesta."
                    },
                    "detail": {
                        "type": "string",
                        "description": "Explicación de este caso en el idioma de la solicitud."
                    }
                },
                "required": [
                    "type",
                    "title",
                    "status"
                ]
            },
            "Product": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID del registro, único entre los registros de su tipo en la tienda."
                    },
                    "external_id": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "ID externo: el ID del registro en tu sistema; null si la aplicación no lo fijó. Cada aplicación ve solo sus propios ID."
                    },
                    "version": {
                        "type": "integer",
                        "description": "Versión del registro: crece con cada cambio. Para cambiar el registro, envíela como ETag en If-Match."
                    },
                    "type": {
                        "type": "string",
                        "enum": [
                            "goods",
                            "dish",
                            "ingredient",
                            "prep",
                            "manufactured",
                            "meal_program",
                            "bundle",
                            "gift_card",
                            "service",
                            "service_package"
                        ],
                        "description": "Tipo de producto: goods — mercadería para la venta; dish — plato que se prepara al pedido; ingredient — materia prima para recetas; prep — semielaborado de preparación propia; manufactured — producción propia de la tienda; meal_program — plan de comidas por suscripción; bundle — combo de otros productos; gift_card — tarjeta de regalo; service — servicio con turno."
                    },
                    "stock_unit": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "properties": {
                            "unit": {
                                "type": "string",
                                "enum": [
                                    "g",
                                    "ml",
                                    "pcs"
                                ],
                                "description": "Unidad base: g — gramos, ml — mililitros, pcs — unidades. Las cantidades de las variantes del producto son textos decimales en esta unidad."
                            },
                            "purchase_unit": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "description": "Nombre del envase de compra, por ejemplo kg o caja; null — el ítem se compra en su unidad base."
                            },
                            "purchase_quantity": {
                                "type": "string",
                                "description": "Cuántas unidades base hay en un envase de compra, como texto decimal: por ejemplo, 1000 para un kilo de un ítem que se lleva en gramos."
                            }
                        },
                        "required": [
                            "unit",
                            "purchase_unit",
                            "purchase_quantity"
                        ],
                        "description": "Unidad de stock de un ítem con stock por medida (insumo, preelaborado, producto fabricado): en ella se llevan el stock, las recetas y el rendimiento. null en mercadería y platos: su unidad es el eje de venta de la variante."
                    },
                    "name": {
                        "type": "object",
                        "additionalProperties": {
                            "type": "string"
                        },
                        "description": "Nombre por idioma: un objeto con los idiomas completados, por ejemplo {\"es\": \"Café\", \"en\": \"Coffee\"}."
                    },
                    "short_description": {
                        "type": "object",
                        "additionalProperties": {
                            "type": "string"
                        },
                        "description": "Descripción breve por idioma, texto plano para las listas de productos."
                    },
                    "description": {
                        "type": "object",
                        "additionalProperties": {
                            "type": "string"
                        },
                        "description": "Descripción por idioma en Markdown (GitHub Flavored): un objeto con los idiomas completados."
                    },
                    "slug": {
                        "type": "string",
                        "description": "Dirección del producto en la tienda online, única en la tienda."
                    },
                    "brand_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID de la marca del producto; null si no está definida."
                    },
                    "tax_class_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID de la clase de impuesto del producto (/v1/tax-classes); null — la clase predeterminada de la tienda. Una venta conserva la alícuota de su ítem: un cambio de clase afecta solo a las ventas futuras."
                    },
                    "category_ids": {
                        "type": "array",
                        "items": {
                            "type": "integer"
                        },
                        "description": "ID de las categorías del producto, en orden ascendente."
                    },
                    "primary_category_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "La categoría principal entre category_ids; null si no se eligió una principal."
                    },
                    "options": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "id": {
                                    "type": "integer",
                                    "description": "ID de la opción."
                                },
                                "key": {
                                    "type": "string",
                                    "description": "Clave técnica de la opción, única en el producto, por ejemplo size."
                                },
                                "name": {
                                    "type": "object",
                                    "additionalProperties": {
                                        "type": "string"
                                    },
                                    "description": "Nombre de la opción por idioma."
                                },
                                "position": {
                                    "type": "integer",
                                    "description": "Posición de la opción: la menor va primero."
                                },
                                "values": {
                                    "type": "array",
                                    "items": {
                                        "type": "object",
                                        "properties": {
                                            "id": {
                                                "type": "integer",
                                                "description": "ID del valor. Las variantes lo nombran en option_values."
                                            },
                                            "value": {
                                                "type": "object",
                                                "additionalProperties": {
                                                    "type": "string"
                                                },
                                                "description": "El valor por idioma, por ejemplo {\"es\": \"Rojo\", \"en\": \"Red\"}."
                                            },
                                            "swatch_color": {
                                                "type": [
                                                    "string",
                                                    "null"
                                                ],
                                                "description": "Color de la muestra, código hexadecimal como #C0392B; null si el valor no tiene muestra."
                                            },
                                            "position": {
                                                "type": "integer",
                                                "description": "Posición del valor: la menor va primero."
                                            }
                                        },
                                        "required": [
                                            "id",
                                            "value",
                                            "swatch_color",
                                            "position"
                                        ]
                                    },
                                    "description": "Valores de la opción en orden."
                                }
                            },
                            "required": [
                                "id",
                                "key",
                                "name",
                                "position",
                                "values"
                            ]
                        },
                        "description": "Opciones en las que difieren las variantes, como talle o color, en orden."
                    },
                    "modifier_groups": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "group_id": {
                                    "type": "integer",
                                    "description": "ID del grupo de modificadores (/v1/modifier-groups)."
                                },
                                "selection_rule": {
                                    "type": [
                                        "object",
                                        "null"
                                    ],
                                    "properties": {
                                        "min_select": {
                                            "type": "integer",
                                            "description": "Cuántas opciones hay que elegir en este producto."
                                        },
                                        "max_select": {
                                            "type": [
                                                "integer",
                                                "null"
                                            ],
                                            "description": "Cuántas opciones se pueden elegir en este producto; null — sin límite."
                                        }
                                    },
                                    "required": [
                                        "min_select",
                                        "max_select"
                                    ],
                                    "description": "Regla de elección en este producto en lugar de la regla del grupo; null — la regla del grupo."
                                }
                            },
                            "required": [
                                "group_id",
                                "selection_rule"
                            ]
                        },
                        "description": "Los grupos de modificadores del producto en orden de exhibición con la regla de elección en este producto. Los recargos de opciones por variante — GET /v1/products/{product}/modifier-groups; PUT en la misma ruta reemplaza los grupos."
                    },
                    "media": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "id": {
                                    "type": "integer",
                                    "description": "ID del archivo en la biblioteca de medios. Un archivo está en la galería de un producto como máximo una vez."
                                },
                                "kind": {
                                    "type": "string",
                                    "enum": [
                                        "image",
                                        "video"
                                    ],
                                    "description": "image — foto; video — video."
                                },
                                "url": {
                                    "type": "string",
                                    "description": "Dirección pública del archivo."
                                },
                                "mime": {
                                    "type": "string",
                                    "description": "Tipo MIME del archivo, por ejemplo image/webp."
                                },
                                "alt": {
                                    "type": "object",
                                    "additionalProperties": {
                                        "type": "string"
                                    },
                                    "description": "Texto alternativo por idioma, para lectores de pantalla y buscadores."
                                },
                                "position": {
                                    "type": "integer",
                                    "description": "Lugar en la galería, desde cero."
                                },
                                "is_primary": {
                                    "type": "boolean",
                                    "description": "La foto principal: la tienda online la muestra primero."
                                }
                            },
                            "required": [
                                "id",
                                "kind",
                                "url",
                                "mime",
                                "alt",
                                "position",
                                "is_primary"
                            ]
                        },
                        "description": "Fotos y videos de la galería en orden: los mismos objetos que en /v1/products/{product}/media."
                    },
                    "is_active": {
                        "type": "boolean",
                        "description": "false retira el producto de la venta y lo oculta de la tienda online."
                    },
                    "published_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Cuándo aparece el producto en la tienda online; null — de inmediato."
                    },
                    "unpublished_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Cuándo sale el producto de la tienda online; null — se queda."
                    },
                    "sale_schedule": {
                        "type": [
                            "array",
                            "null"
                        ],
                        "items": {
                            "type": "object",
                            "properties": {
                                "days": {
                                    "type": "array",
                                    "items": {
                                        "type": "integer"
                                    },
                                    "description": "Días de la franja, ISO: 1 es lunes, 7 es domingo."
                                },
                                "from": {
                                    "type": "string",
                                    "description": "Inicio de la franja, «HH:MM» según el reloj del comercio."
                                },
                                "to": {
                                    "type": "string",
                                    "description": "Fin de la franja, «HH:MM», sin incluir ese momento; «24:00» — hasta el final del día. Un fin anterior al inicio hace que la franja pase la medianoche; pertenece a su día de inicio."
                                }
                            },
                            "required": [
                                "days",
                                "from",
                                "to"
                            ]
                        },
                        "description": "Cuándo se puede pedir el producto — franjas de la semana en la zona horaria del comercio; null — siempre. Fuera de la franja el producto sigue visible y se puede agregar al carrito, y el checkout compara el horario con el momento de entrega del pedido."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo se creó el registro."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo cambió el registro por última vez."
                    },
                    "deleted_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Cuándo se archivó el producto con sus variantes; null en un producto vigente."
                    }
                },
                "required": [
                    "id",
                    "external_id",
                    "version",
                    "type",
                    "stock_unit",
                    "name",
                    "short_description",
                    "description",
                    "slug",
                    "brand_id",
                    "tax_class_id",
                    "category_ids",
                    "primary_category_id",
                    "options",
                    "modifier_groups",
                    "media",
                    "is_active",
                    "published_at",
                    "unpublished_at",
                    "sale_schedule",
                    "created_at",
                    "updated_at",
                    "deleted_at"
                ]
            },
            "ProductMedia": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID del archivo en la biblioteca de medios. Un archivo está en la galería de un producto como máximo una vez."
                    },
                    "kind": {
                        "type": "string",
                        "enum": [
                            "image",
                            "video"
                        ],
                        "description": "image — foto; video — video."
                    },
                    "url": {
                        "type": "string",
                        "description": "Dirección pública del archivo."
                    },
                    "mime": {
                        "type": "string",
                        "description": "Tipo MIME del archivo, por ejemplo image/webp."
                    },
                    "alt": {
                        "type": "object",
                        "additionalProperties": {
                            "type": "string"
                        },
                        "description": "Texto alternativo por idioma, para lectores de pantalla y buscadores."
                    },
                    "position": {
                        "type": "integer",
                        "description": "Lugar en la galería, desde cero."
                    },
                    "is_primary": {
                        "type": "boolean",
                        "description": "La foto principal: la tienda online la muestra primero."
                    }
                },
                "required": [
                    "id",
                    "kind",
                    "url",
                    "mime",
                    "alt",
                    "position",
                    "is_primary"
                ]
            },
            "ProductModifierGroups": {
                "type": "object",
                "properties": {
                    "product_id": {
                        "type": "integer",
                        "description": "ID del producto. Los grupos se versionan en su ficha: ETag e If-Match llevan la versión del producto."
                    },
                    "version": {
                        "type": "integer",
                        "description": "Versión del registro: crece con cada cambio. Para cambiar el registro, envíela como ETag en If-Match."
                    },
                    "groups": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "group_id": {
                                    "type": "integer",
                                    "description": "ID del grupo de modificadores (/v1/modifier-groups)."
                                },
                                "selection_rule": {
                                    "type": [
                                        "object",
                                        "null"
                                    ],
                                    "properties": {
                                        "min_select": {
                                            "type": "integer",
                                            "description": "Cuántas opciones hay que elegir en este producto."
                                        },
                                        "max_select": {
                                            "type": [
                                                "integer",
                                                "null"
                                            ],
                                            "description": "Cuántas opciones se pueden elegir en este producto; null — sin límite."
                                        }
                                    },
                                    "required": [
                                        "min_select",
                                        "max_select"
                                    ],
                                    "description": "Regla de elección en este producto en lugar de la regla del grupo; null — la regla del grupo."
                                }
                            },
                            "required": [
                                "group_id",
                                "selection_rule"
                            ]
                        },
                        "description": "Los grupos de modificadores del producto en orden de exhibición. Al escribir, el conjunto completo."
                    },
                    "option_prices": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "option_id": {
                                    "type": "integer",
                                    "description": "ID de una opción de los grupos del producto."
                                },
                                "variant_id": {
                                    "type": "integer",
                                    "description": "ID de la variante del producto."
                                },
                                "is_available": {
                                    "type": "boolean",
                                    "description": "false — la opción no se ofrece en esta variante; esa fila no tiene recargo."
                                },
                                "price_delta": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "Recargo de la opción en esta variante, entero en unidades menores de la moneda de la tienda; null solo en una opción no disponible."
                                }
                            },
                            "required": [
                                "option_id",
                                "variant_id",
                                "is_available",
                                "price_delta"
                            ]
                        },
                        "description": "Recargo y disponibilidad de opciones en las variantes del producto en lugar del recargo de la opción. Al escribir, reemplaza los ajustes completos; sin el campo quedan los anteriores, salvo los de grupos quitados."
                    }
                },
                "required": [
                    "product_id",
                    "version",
                    "groups",
                    "option_prices"
                ]
            },
            "PurchaseOrder": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID del registro, único entre los registros de su tipo en la tienda."
                    },
                    "version": {
                        "type": "integer",
                        "description": "Versión del registro: crece con cada cambio. Para cambiar el registro, envíela como ETag en If-Match."
                    },
                    "number": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Número de la orden; null en una orden creada antes de la numeración."
                    },
                    "status": {
                        "type": "string",
                        "enum": [
                            "draft",
                            "sent",
                            "partial",
                            "received",
                            "closed",
                            "cancelled"
                        ],
                        "description": "draft: borrador, no enviada al proveedor; sent: emitida, se espera la entrega; partial: recibida en parte; received: recibida por completo; closed: cerrada por la tienda, recibida completa o con faltante (closed_short); cancelled: cancelada."
                    },
                    "supplier_id": {
                        "type": "integer",
                        "description": "ID del proveedor (/v1/suppliers)."
                    },
                    "location_id": {
                        "type": "integer",
                        "description": "Local donde se espera la entrega (/v1/locations)."
                    },
                    "legal_entity_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Razón social compradora de la tienda (/v1/legal-entities); null en una orden creada antes de que la tienda tuviera razones sociales."
                    },
                    "currency": {
                        "type": "string",
                        "description": "Moneda de la orden, ISO 4217: en ella van los precios de las líneas y los totales."
                    },
                    "prices_include_tax": {
                        "type": "boolean",
                        "description": "true: los precios de las líneas incluyen impuestos; false: no los incluyen."
                    },
                    "ordered_total": {
                        "type": "integer",
                        "description": "Valor de lo pedido vigente; en una línea cerrada, de lo recibido."
                    },
                    "received_total": {
                        "type": "integer",
                        "description": "Valor de lo recibido contra la orden."
                    },
                    "expected_on": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date",
                        "description": "Cuándo la tienda espera la entrega, YYYY-MM-DD; null si no se fijó."
                    },
                    "next_delivery_on": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date",
                        "description": "Próxima entrega esperada según las fechas que prometió el proveedor, YYYY-MM-DD; null si no se espera nada."
                    },
                    "placed_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Cuándo la orden se envió por primera vez al proveedor; null en un borrador y en una orden cancelada antes de enviarse."
                    },
                    "closed_short": {
                        "type": "boolean",
                        "description": "true: la orden se cerró con faltante y el resto ya no se espera."
                    },
                    "supplier_response": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "enum": [
                            "awaiting",
                            "confirmed",
                            "changed",
                            "declined",
                            null
                        ],
                        "description": "Respuesta del proveedor: awaiting: pendiente; confirmed: confirmó tal cual; changed: confirmó con cambios (confirmed_quantity y promised_on de las líneas); declined: rechazó; null: no se siguen las respuestas."
                    },
                    "revision": {
                        "type": "integer",
                        "description": "Revisión de las condiciones que ve el proveedor: crece con cada cambio de una orden emitida."
                    },
                    "note": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Nota del personal; null si no hay."
                    },
                    "lines": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "id": {
                                    "type": "integer",
                                    "description": "ID del registro, único entre los registros de su tipo en la tienda."
                                },
                                "variant_id": {
                                    "type": "integer",
                                    "description": "ID de la variante del producto (/v1/variants)."
                                },
                                "unit": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "description": "Unidad base de las cantidades de la línea: pcs, unidades; g, gramos; ml, mililitros."
                                },
                                "ordered_quantity": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "description": "Cantidad pedida, texto decimal en la unidad base."
                                },
                                "confirmed_quantity": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "description": "Cantidad que confirmó el proveedor; null si no respondió por la línea."
                                },
                                "received_quantity": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "description": "Cantidad recibida contra la línea."
                                },
                                "unit_cost": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "Precio en la moneda de la orden por cost_per_quantity; null si no hay precio."
                                },
                                "cost_per_quantity": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "description": "Cantidad en la unidad base a la que corresponde el precio: \"1000\" en un producto por peso es por kilo."
                                },
                                "ordered_amount": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "Valor de la cantidad vigente de la línea; null sin precio. La suma de las líneas da ordered_total."
                                },
                                "received_amount": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "Valor de lo recibido por la línea; null sin precio. La suma de las líneas da received_total."
                                },
                                "promised_on": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "format": "date",
                                    "description": "Fecha de entrega prometida por el proveedor, YYYY-MM-DD; null si no la prometió y se espera para expected_on."
                                },
                                "closed_at": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "format": "date-time",
                                    "description": "Cuándo se cerró la línea y se dejó de esperar el resto; null en una línea abierta."
                                }
                            },
                            "required": [
                                "id",
                                "variant_id",
                                "unit",
                                "ordered_quantity",
                                "confirmed_quantity",
                                "received_quantity",
                                "unit_cost",
                                "cost_per_quantity",
                                "ordered_amount",
                                "received_amount",
                                "promised_on",
                                "closed_at"
                            ]
                        },
                        "description": "Líneas de la orden en su orden."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo se creó el registro."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo cambió el registro por última vez."
                    }
                },
                "required": [
                    "id",
                    "version",
                    "number",
                    "status",
                    "supplier_id",
                    "location_id",
                    "legal_entity_id",
                    "currency",
                    "prices_include_tax",
                    "ordered_total",
                    "received_total",
                    "expected_on",
                    "next_delivery_on",
                    "placed_at",
                    "closed_short",
                    "supplier_response",
                    "revision",
                    "note",
                    "lines",
                    "created_at",
                    "updated_at"
                ]
            },
            "RateLimitProblem": {
                "type": "object",
                "properties": {
                    "type": {
                        "type": "string",
                        "description": "Tipo técnico del problema: un código estable para decidir qué hacer, como insufficient_scope. Cada tipo tiene una página en el catálogo de errores."
                    },
                    "title": {
                        "type": "string",
                        "description": "Resumen breve del problema en el idioma de la solicitud."
                    },
                    "status": {
                        "type": "integer",
                        "description": "Estado HTTP de la respuesta."
                    },
                    "detail": {
                        "type": "string",
                        "description": "Explicación de este caso en el idioma de la solicitud."
                    },
                    "policy": {
                        "type": "string",
                        "enum": [
                            "app",
                            "store",
                            "rejected"
                        ],
                        "description": "Qué balde se agotó: app — el de la aplicación; store — el de la tienda, compartido por todas sus aplicaciones; rejected — el de solicitudes de una misma dirección rechazadas en la entrada."
                    }
                },
                "required": [
                    "type",
                    "title",
                    "status",
                    "policy"
                ]
            },
            "RecommendationRule": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID del registro, único entre los registros de su tipo en la tienda."
                    },
                    "version": {
                        "type": "integer",
                        "description": "Versión del registro: crece con cada cambio. Para cambiar el registro, envíela como ETag en If-Match."
                    },
                    "position": {
                        "type": "integer",
                        "description": "Prioridad: la regla con el valor menor se aplica antes."
                    },
                    "source_type": {
                        "type": "string",
                        "enum": [
                            "category",
                            "collection"
                        ],
                        "description": "A qué se aplica la regla: category — productos de la categoría y sus subcategorías; collection — productos de la colección."
                    },
                    "source_id": {
                        "type": "integer",
                        "description": "ID de la categoría o colección a cuyos productos se aplica la regla. Cada origen tiene una sola regla."
                    },
                    "target_collection_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID de la colección cuyos productos ofrece la regla después de los suyos; null — sin colección."
                    },
                    "product_ids": {
                        "type": "array",
                        "items": {
                            "type": "integer"
                        },
                        "description": "ID de los productos que ofrece la regla, en el orden del estante; como máximo 20."
                    },
                    "exclusive": {
                        "type": "boolean",
                        "description": "true — «solo esta regla»: las reglas de abajo y la selección automática no completan el estante; sin productos ni colección oculta el estante."
                    },
                    "is_active": {
                        "type": "boolean",
                        "description": "false apaga la regla: se guarda pero no se aplica."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo se creó el registro."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo cambió el registro por última vez."
                    }
                },
                "required": [
                    "id",
                    "version",
                    "position",
                    "source_type",
                    "source_id",
                    "target_collection_id",
                    "product_ids",
                    "exclusive",
                    "is_active",
                    "created_at",
                    "updated_at"
                ]
            },
            "RecommendationRuleSource": {
                "type": "string",
                "enum": [
                    "category",
                    "collection"
                ]
            },
            "RecordCustomerAccountPaymentRequest": {
                "type": "object",
                "properties": {
                    "amount": {
                        "type": "integer",
                        "minimum": 1,
                        "maximum": 10000000000,
                        "description": "Cuánto dinero entró a cuenta de la deuda, en unidades mínimas de la moneda de la tienda."
                    },
                    "payment_method": {
                        "type": "string",
                        "enum": [
                            "cash",
                            "mercadopago",
                            "crypto",
                            "bybit",
                            "trc20",
                            "balance",
                            "modo",
                            "payway",
                            "mercadopago_qr",
                            "mercadopago_point",
                            "mercadopago_transfer",
                            "gift_card",
                            "subscription",
                            "deposit",
                            "external",
                            "manual",
                            "offset",
                            "on_account",
                            "exchange_credit",
                            "bonpunto",
                            "service_package"
                        ],
                        "description": "Medio con el que entró el dinero: tiene que cancelar deuda y confirmarse a mano, por ejemplo efectivo o el medio manual."
                    },
                    "manual_payment_method_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "minimum": 1,
                        "description": "ID del medio de pago manual (/v1/manual-payment-methods) con payment_method=manual, por ejemplo una transferencia bancaria."
                    },
                    "location_id": {
                        "type": "integer",
                        "description": "ID del local de la tienda."
                    },
                    "legal_entity_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID de la razón social de la tienda (/v1/legal-entities) cuya deuda se cancela: hace falta cuando el cliente le debe a varias."
                    },
                    "withholdings": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "regime": {
                                    "type": "string",
                                    "description": "Impuesto retenido: vat, turnover, income y otros códigos de TaxRegime."
                                },
                                "jurisdiction": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "pattern": "^[A-Z]{2}-[A-Z0-9]{1,5}$",
                                    "maxLength": 8,
                                    "description": "Jurisdicción de un impuesto provincial o municipal, por ejemplo AR-B; null en los impuestos nacionales."
                                },
                                "amount": {
                                    "type": "integer",
                                    "minimum": 1,
                                    "description": "Importe retenido en unidades mínimas de la moneda de la tienda."
                                },
                                "certificate_number": {
                                    "type": "string",
                                    "maxLength": 64,
                                    "description": "Número del certificado de retención."
                                }
                            },
                            "required": [
                                "regime",
                                "amount",
                                "certificate_number"
                            ]
                        },
                        "minItems": 1,
                        "maxItems": 2000,
                        "description": "Certificados de retención que el cliente agente entregó con el dinero: cancelan la deuda igual que el dinero."
                    },
                    "withheld_on": {
                        "type": "string",
                        "format": "date",
                        "description": "Día de la retención, YYYY-MM-DD: ubica el certificado en un período fiscal y un período cerrado se rechaza."
                    },
                    "withholding_agent_tax_id": {
                        "type": "string",
                        "maxLength": 20,
                        "description": "CUIT del cliente agente que retuvo el impuesto."
                    }
                },
                "required": [
                    "amount",
                    "payment_method",
                    "location_id"
                ]
            },
            "RecordOutOfBandSupplierBillPaymentRequest": {
                "type": "object",
                "properties": {
                    "amount": {
                        "type": "integer",
                        "maximum": 10000000000,
                        "description": "Cuánto de la deuda se cancela, en unidades mínimas de la moneda del comprobante: no más que el saldo pendiente (outstanding). Las retenciones forman parte de este importe: el proveedor recibió amount menos las retenciones."
                    },
                    "paid_on": {
                        "type": "string",
                        "format": "date",
                        "description": "Día del pago, YYYY-MM-DD en la zona horaria de la tienda, no futuro: con él las retenciones caen en un período fiscal, y un período cerrado es un rechazo."
                    },
                    "note": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 1000,
                        "description": "Nota del pago, por ejemplo el número de la transferencia bancaria; null si no hay nota."
                    },
                    "withholdings": {
                        "type": [
                            "array",
                            "null"
                        ],
                        "items": {
                            "type": "object",
                            "properties": {
                                "regime": {
                                    "type": "string",
                                    "enum": [
                                        "vat",
                                        "income",
                                        "turnover",
                                        "municipal",
                                        "internal",
                                        "social",
                                        "other"
                                    ],
                                    "description": "Impuesto retenido: vat, turnover, income y otros códigos de TaxRegime."
                                },
                                "amount": {
                                    "type": "integer",
                                    "maximum": 10000000000,
                                    "description": "Importe de la retención en unidades mínimas de la moneda del comprobante; el total de retenciones es menor que amount. Se descuenta del pago al proveedor. Si el comprobante está en otra moneda, en tax-withholdings queda el equivalente en la moneda de la tienda a la cotización del día del pago; sin cotización, 422."
                                },
                                "jurisdiction": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "pattern": "^[A-Z]{2}-[A-Z0-9]{1,5}$",
                                    "maxLength": 8,
                                    "description": "Jurisdicción de un impuesto provincial o municipal, por ejemplo AR-B: obligatoria en turnover y municipal. null para impuestos nacionales."
                                },
                                "certificate_number": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "maxLength": 64,
                                    "description": "Número del certificado de retención entregado al proveedor; null para que la tienda asigne un número de su propia serie."
                                },
                                "rate_bps": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "minimum": 0,
                                    "maximum": 10000,
                                    "description": "Alícuota de la retención en centésimos de punto porcentual (250 es 2,5 %); null si no se conoce."
                                },
                                "rate_source": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "enum": [
                                        "padron",
                                        "default",
                                        "manual",
                                        null
                                    ],
                                    "description": "Origen de la alícuota: padron es el padrón de ARCA o de la provincia, default la alícuota por defecto, manual la cargada a mano; null si no se indica."
                                }
                            },
                            "required": [
                                "regime",
                                "amount"
                            ]
                        },
                        "maxItems": 20,
                        "description": "Retenciones que la tienda practicó en este pago al proveedor. Para una razón social agente de retención la lista es obligatoria: una lista vacía significa que no hubo retención, y la falta del campo es un rechazo. Las demás razones sociales no necesitan el campo."
                    }
                },
                "required": [
                    "amount",
                    "paid_on"
                ]
            },
            "Refund": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID del registro, único entre los registros de su tipo en la tienda."
                    },
                    "order_id": {
                        "type": "integer",
                        "description": "ID del pedido."
                    },
                    "pos_shift_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID del turno de caja (/v1/pos-shifts) que hizo la devolución; null — no se devolvió en una caja."
                    },
                    "kind": {
                        "type": "string",
                        "enum": [
                            "return",
                            "adjustment",
                            "overpayment",
                            "tip"
                        ],
                        "description": "return — devolución de mercadería; adjustment — corrección del importe sin mercadería; overpayment — devolución de un pago de más; tip — devolución de una propina."
                    },
                    "status": {
                        "type": "string",
                        "enum": [
                            "pending",
                            "completed",
                            "failed",
                            "reversed"
                        ],
                        "description": "pending — espera al proveedor o un pago manual; completed — realizado; failed — fallido; reversed — revertido después de realizarse."
                    },
                    "app_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "La aplicación que hizo el reembolso (/v1/orders/{order}/refunds o la cancelación de un pedido), su id de /v1/me; null en un reembolso de la caja, el personal, el cliente o un proceso automático."
                    },
                    "confirmable": {
                        "type": "boolean",
                        "description": "El reembolso espera la confirmación de que el dinero se devolvió fuera del sistema (POST /v1/refunds/{refund}/confirm)."
                    },
                    "currency": {
                        "type": "string",
                        "description": "Moneda de los importes, código ISO 4217: la moneda de la tienda."
                    },
                    "amount": {
                        "type": "integer",
                        "description": "Importe del reembolso: ítems y envío."
                    },
                    "shipping_amount": {
                        "type": "integer",
                        "description": "Parte de amount que reembolsa el envío."
                    },
                    "tax_lines": {
                        "type": [
                            "array",
                            "null"
                        ],
                        "items": {
                            "$ref": "#/components/schemas/TaxLine"
                        },
                        "description": "Impuesto de lo devuelto según la clasificación de los productos: la composición de la nota de crédito de la devolución, con los ítems devueltos salvo tarjetas de regalo y el envío; en una devolución de un importe sin ítems, la parte gravable por la clase impositiva predeterminada de la tienda. null cuando la tienda no tiene clases impositivas o no se devolvió nada gravable (una tarjeta de regalo)."
                    },
                    "exchanged_to_order_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "El pedido entregado a cambio (un cambio); null en un reembolso común."
                    },
                    "items": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "order_item_id": {
                                    "type": "integer",
                                    "description": "ID del ítem del pedido (items en /v1/orders)."
                                },
                                "quantity": {
                                    "type": "string",
                                    "description": "Cantidad como cadena decimal en unit: unidades, o la medida completa de un ítem por peso o volumen."
                                },
                                "unit": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "enum": [
                                        "pcs",
                                        "g",
                                        "ml",
                                        null
                                    ],
                                    "description": "Unidad de quantity: pcs, g o ml; null si la variante ya no conoce la unidad de su medida."
                                },
                                "amount": {
                                    "type": "integer",
                                    "description": "Importe reembolsado por el ítem."
                                }
                            },
                            "required": [
                                "order_item_id",
                                "quantity",
                                "unit",
                                "amount"
                            ]
                        },
                        "description": "Ítems devueltos."
                    },
                    "transactions": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "id": {
                                    "type": "integer",
                                    "description": "ID del movimiento."
                                },
                                "payment_id": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "Pago del pedido por el que vuelve el dinero; null si no hay tal pago, como en un reembolso al saldo."
                                },
                                "method": {
                                    "type": "string",
                                    "enum": [
                                        "cash",
                                        "mercadopago",
                                        "crypto",
                                        "bybit",
                                        "trc20",
                                        "balance",
                                        "modo",
                                        "payway",
                                        "mercadopago_qr",
                                        "mercadopago_point",
                                        "mercadopago_transfer",
                                        "gift_card",
                                        "subscription",
                                        "deposit",
                                        "external",
                                        "manual",
                                        "offset",
                                        "on_account",
                                        "exchange_credit",
                                        "bonpunto",
                                        "service_package"
                                    ],
                                    "description": "Medio de pago del movimiento, los mismos valores que method de un pago."
                                },
                                "target": {
                                    "type": "string",
                                    "enum": [
                                        "card",
                                        "cash",
                                        "balance",
                                        "gift_card",
                                        "account",
                                        "manual",
                                        "exchange",
                                        "subscription",
                                        "deposit",
                                        "service_package"
                                    ],
                                    "description": "A dónde va el dinero: card — de vuelta a la tarjeta por el proveedor; cash — en efectivo; balance — al saldo del cliente; gift_card — a una tarjeta de regalo; account — a cuenta de la deuda del cliente; manual — devuelto a mano fuera del sistema; exchange — al pedido de un cambio; subscription — a una suscripción; deposit — a un depósito."
                                },
                                "amount": {
                                    "type": "integer",
                                    "description": "Importe del movimiento."
                                },
                                "status": {
                                    "type": "string",
                                    "enum": [
                                        "pending",
                                        "completed",
                                        "failed",
                                        "reversed"
                                    ],
                                    "description": "pending, completed, failed o reversed, como status del reembolso."
                                },
                                "provider_refund_id": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "description": "ID del reembolso en el proveedor de pagos, para conciliar con su resumen; null si no hay proveedor."
                                }
                            },
                            "required": [
                                "id",
                                "payment_id",
                                "method",
                                "target",
                                "amount",
                                "status",
                                "provider_refund_id"
                            ]
                        },
                        "description": "A dónde fue el dinero: movimientos por los pagos del pedido."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo se creó el registro."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo cambió el registro por última vez."
                    }
                },
                "required": [
                    "id",
                    "order_id",
                    "pos_shift_id",
                    "kind",
                    "status",
                    "app_id",
                    "confirmable",
                    "currency",
                    "amount",
                    "shipping_amount",
                    "tax_lines",
                    "exchanged_to_order_id",
                    "items",
                    "transactions",
                    "created_at",
                    "updated_at"
                ]
            },
            "RefundCalculation": {
                "type": "object",
                "properties": {
                    "order_id": {
                        "type": "integer",
                        "description": "ID del pedido."
                    },
                    "currency": {
                        "type": "string",
                        "description": "Moneda de los importes, código ISO 4217: la moneda de la tienda."
                    },
                    "amount": {
                        "type": "integer",
                        "description": "Importe que se reembolsará por los ítems y el envío elegidos."
                    },
                    "shipping_amount": {
                        "type": "integer",
                        "description": "Parte de amount que reembolsa el envío."
                    },
                    "items": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "order_item_id": {
                                    "type": "integer",
                                    "description": "ID del ítem del pedido (items en /v1/orders)."
                                },
                                "quantity": {
                                    "type": "string",
                                    "description": "Cantidad como cadena decimal en unit: unidades, o la medida completa de un ítem por peso o volumen."
                                },
                                "unit": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "enum": [
                                        "pcs",
                                        "g",
                                        "ml",
                                        null
                                    ],
                                    "description": "Unidad de quantity: pcs, g o ml; null si la variante ya no conoce la unidad de su medida."
                                },
                                "amount": {
                                    "type": "integer",
                                    "description": "Importe reembolsado por el ítem."
                                }
                            },
                            "required": [
                                "order_item_id",
                                "quantity",
                                "unit",
                                "amount"
                            ]
                        },
                        "description": "Ítems que se devolverán."
                    },
                    "transactions": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "payment_id": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "Pago del pedido por el que vuelve el dinero; null si no hay tal pago, como en un reembolso al saldo."
                                },
                                "method": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "enum": [
                                        "cash",
                                        "mercadopago",
                                        "crypto",
                                        "bybit",
                                        "trc20",
                                        "balance",
                                        "modo",
                                        "payway",
                                        "mercadopago_qr",
                                        "mercadopago_point",
                                        "mercadopago_transfer",
                                        "gift_card",
                                        "subscription",
                                        "deposit",
                                        "external",
                                        "manual",
                                        "offset",
                                        "on_account",
                                        "exchange_credit",
                                        "bonpunto",
                                        "service_package",
                                        null
                                    ],
                                    "description": "Medio de pago de la parte; null en una parte sin pago."
                                },
                                "target": {
                                    "type": "string",
                                    "enum": [
                                        "card",
                                        "cash",
                                        "balance",
                                        "gift_card",
                                        "account",
                                        "manual",
                                        "exchange",
                                        "subscription",
                                        "deposit",
                                        "service_package"
                                    ],
                                    "description": "A dónde va el dinero: card — de vuelta a la tarjeta por el proveedor; cash — en efectivo; balance — al saldo del cliente; gift_card — a una tarjeta de regalo; account — a cuenta de la deuda del cliente; manual — devuelto a mano fuera del sistema; exchange — al pedido de un cambio; subscription — a una suscripción; deposit — a un depósito."
                                },
                                "amount": {
                                    "type": "integer",
                                    "description": "Importe del movimiento."
                                }
                            },
                            "required": [
                                "payment_id",
                                "method",
                                "target",
                                "amount"
                            ]
                        },
                        "description": "A dónde irá el dinero: partes por los pagos del pedido, tal como las hará el reembolso."
                    },
                    "balance_available": {
                        "type": "boolean",
                        "description": "La parte de un medio irreversible (transferencia, cripto, medio manual) puede ir al saldo del cliente: irreversible_to: balance en el reembolso. Hay tal parte en el cálculo, el cliente tiene cuenta y la tienda trabaja con saldos."
                    },
                    "refundable": {
                        "type": "object",
                        "properties": {
                            "items": {
                                "type": "array",
                                "items": {
                                    "type": "object",
                                    "properties": {
                                        "order_item_id": {
                                            "type": "integer",
                                            "description": "ID del ítem del pedido (items en /v1/orders)."
                                        },
                                        "quantity": {
                                            "type": "string",
                                            "description": "Cantidad que todavía se puede devolver, como cadena decimal en unit."
                                        },
                                        "unit": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "enum": [
                                                "pcs",
                                                "g",
                                                "ml",
                                                null
                                            ],
                                            "description": "Unidad de quantity: pcs, g o ml; null si la variante ya no conoce la unidad de su medida."
                                        }
                                    },
                                    "required": [
                                        "order_item_id",
                                        "quantity",
                                        "unit"
                                    ]
                                },
                                "description": "Ítems con cantidad pendiente de reembolso."
                            },
                            "shipping_amount": {
                                "type": "integer",
                                "description": "Envío que todavía se puede reembolsar."
                            }
                        },
                        "required": [
                            "items",
                            "shipping_amount"
                        ],
                        "description": "Lo que todavía se puede reembolsar del pedido: ítems con cantidad pendiente y el resto del envío. Un reembolso revertido no lo consume."
                    }
                },
                "required": [
                    "order_id",
                    "currency",
                    "amount",
                    "shipping_amount",
                    "items",
                    "transactions",
                    "balance_available",
                    "refundable"
                ]
            },
            "ReissueFiscalDocumentRequest": {
                "type": "object",
                "properties": {
                    "receptor": {
                        "type": "object",
                        "properties": {
                            "id_type": {
                                "type": "string",
                                "enum": [
                                    "tax_id",
                                    "personal_id",
                                    "national_id",
                                    "passport",
                                    "none"
                                ],
                                "description": "Tipo de identificación: tax_id — CUIT de una empresa; personal_id — CUIL de una persona; national_id — DNI; passport — pasaporte; none — sin identificación."
                            },
                            "id_number": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "maxLength": 32,
                                "description": "Número de la identificación; null cuando id_type es none."
                            },
                            "name": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "maxLength": 255,
                                "description": "Razón social o nombre completo para el comprobante; null si no se indicó."
                            },
                            "tax_status": {
                                "type": "string",
                                "enum": [
                                    "registered",
                                    "small_taxpayer",
                                    "exempt",
                                    "final_consumer",
                                    "not_categorized",
                                    "foreign"
                                ],
                                "description": "Condición frente al IVA: registered — Responsable Inscripto; small_taxpayer — Monotributo; exempt — exento; final_consumer — consumidor final; not_categorized — no categorizado; foreign — cliente del exterior."
                            },
                            "address": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "maxLength": 255,
                                "description": "Domicilio fiscal en una línea; null si no se indicó."
                            }
                        },
                        "description": "Datos corregidos del receptor de una factura rechazada; también reemplazan los datos del pedido. Solo facturas: las notas heredan el receptor de su factura. No lo envíes si los datos no cambian."
                    },
                    "refresh_receptor": {
                        "type": "boolean",
                        "description": "true — volver a leer los datos del perfil fiscal actual del cliente del pedido (PUT /v1/customers/{customer}/fiscal-profile). No junto con receptor."
                    }
                }
            },
            "RemovePriceListItemsRequest": {
                "type": "object",
                "properties": {
                    "variant_ids": {
                        "type": "array",
                        "items": {
                            "type": "integer"
                        },
                        "minItems": 1,
                        "maxItems": 1000,
                        "uniqueItems": true,
                        "description": "IDs de las variantes cuyos precios fijos se quitan, sin repetir, hasta 1000 por solicitud. Se omite la variante sin precio fijo."
                    }
                },
                "required": [
                    "variant_ids"
                ]
            },
            "RemovePriceListModifierItemsRequest": {
                "type": "object",
                "properties": {
                    "items": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "modifier_option_id": {
                                    "type": "integer",
                                    "description": "ID de la opción de modificador."
                                },
                                "variant_id": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "Variante cuyo recargo se quita; null o sin el campo, el recargo para todas las variantes."
                                }
                            },
                            "required": [
                                "modifier_option_id"
                            ]
                        },
                        "minItems": 1,
                        "maxItems": 1000,
                        "description": "Recargos fijos que se quitan, hasta 1000 por solicitud. Se omite el par sin recargo fijo."
                    }
                },
                "required": [
                    "items"
                ]
            },
            "ReplaceCustomerFiscalProfileRequest": {
                "type": "object",
                "properties": {
                    "receptor": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "properties": {
                            "id_type": {
                                "type": "string",
                                "enum": [
                                    "tax_id",
                                    "personal_id",
                                    "national_id",
                                    "passport",
                                    "none"
                                ],
                                "description": "Tipo de identificación: tax_id — CUIT de una empresa; personal_id — CUIL de una persona; national_id — DNI; passport — pasaporte; none — sin identificación."
                            },
                            "id_number": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "maxLength": 32,
                                "description": "Número de la identificación; null cuando id_type es none."
                            },
                            "name": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "maxLength": 255,
                                "description": "Razón social o nombre completo para el comprobante; null si no se indicó."
                            },
                            "tax_status": {
                                "type": "string",
                                "enum": [
                                    "registered",
                                    "small_taxpayer",
                                    "exempt",
                                    "final_consumer",
                                    "not_categorized",
                                    "foreign"
                                ],
                                "description": "Condición frente al IVA: registered — Responsable Inscripto; small_taxpayer — Monotributo; exempt — exento; final_consumer — consumidor final; not_categorized — no categorizado; foreign — cliente del exterior."
                            },
                            "address": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "maxLength": 255,
                                "description": "Domicilio fiscal en una línea; null si no se indicó."
                            }
                        },
                        "description": "Datos fiscales con los que se emiten los comprobantes de los pedidos nuevos; null — un cliente minorista sin datos fiscales. Un pedido ya confirmado guarda su propia copia (fiscal_receptor del pedido)."
                    }
                },
                "required": [
                    "receptor"
                ]
            },
            "ReplaceProductModifierGroupsRequest": {
                "type": "object",
                "properties": {
                    "groups": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "group_id": {
                                    "type": "integer",
                                    "description": "ID del grupo de modificadores (/v1/modifier-groups)."
                                },
                                "selection_rule": {
                                    "type": [
                                        "object",
                                        "null"
                                    ],
                                    "properties": {
                                        "min_select": {
                                            "type": "integer",
                                            "minimum": 0,
                                            "maximum": 99,
                                            "description": "Cuántas opciones hay que elegir en este producto."
                                        },
                                        "max_select": {
                                            "type": [
                                                "integer",
                                                "null"
                                            ],
                                            "minimum": 1,
                                            "maximum": 99,
                                            "description": "Cuántas opciones se pueden elegir en este producto; null — sin límite."
                                        }
                                    },
                                    "description": "Regla de elección en este producto en lugar de la regla del grupo; null — la regla del grupo."
                                }
                            },
                            "required": [
                                "group_id"
                            ]
                        },
                        "maxItems": 50,
                        "uniqueItems": true,
                        "description": "Los grupos de modificadores del producto en orden de exhibición. Al escribir, el conjunto completo."
                    },
                    "option_prices": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "option_id": {
                                    "type": "integer",
                                    "description": "ID de una opción de los grupos del producto."
                                },
                                "is_available": {
                                    "type": "boolean",
                                    "description": "false — la opción no se ofrece en esta variante; esa fila no tiene recargo."
                                },
                                "price_delta": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "minimum": -100000000,
                                    "maximum": 100000000,
                                    "description": "Recargo de la opción en esta variante, entero en unidades menores de la moneda de la tienda; null solo en una opción no disponible."
                                },
                                "variant_id": {
                                    "type": "integer",
                                    "description": "ID de la variante del producto."
                                }
                            },
                            "required": [
                                "option_id",
                                "is_available",
                                "variant_id"
                            ]
                        },
                        "maxItems": 2000,
                        "description": "Recargo y disponibilidad de opciones en las variantes del producto en lugar del recargo de la opción. Al escribir, reemplaza los ajustes completos; sin el campo quedan los anteriores, salvo los de grupos quitados."
                    }
                },
                "required": [
                    "groups"
                ]
            },
            "ReplaceProductOptionsRequest": {
                "type": "object",
                "properties": {
                    "options": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "key": {
                                    "type": "string",
                                    "pattern": "^[a-z][a-z0-9_]*$",
                                    "maxLength": 32,
                                    "description": "Clave técnica de la opción, única en el producto, por ejemplo size."
                                },
                                "name": {
                                    "type": "object",
                                    "additionalProperties": {
                                        "type": [
                                            "string",
                                            "null"
                                        ],
                                        "maxLength": 120
                                    },
                                    "description": "Nombre de la opción por idioma."
                                },
                                "values": {
                                    "type": "array",
                                    "items": {
                                        "type": "object",
                                        "properties": {
                                            "value": {
                                                "type": "object",
                                                "additionalProperties": {
                                                    "type": [
                                                        "string",
                                                        "null"
                                                    ],
                                                    "maxLength": 120
                                                },
                                                "description": "El valor por idioma, por ejemplo {\"es\": \"Rojo\", \"en\": \"Red\"}."
                                            },
                                            "swatch_color": {
                                                "type": [
                                                    "string",
                                                    "null"
                                                ],
                                                "pattern": "^#(?:[0-9a-fA-F]{3,4}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$",
                                                "maxLength": 16,
                                                "description": "Color de la muestra, código hexadecimal como #C0392B; null si el valor no tiene muestra."
                                            },
                                            "id": {
                                                "type": [
                                                    "integer",
                                                    "null"
                                                ],
                                                "description": "ID del valor. Las variantes lo nombran en option_values."
                                            }
                                        },
                                        "required": [
                                            "value"
                                        ]
                                    },
                                    "minItems": 1,
                                    "maxItems": 50,
                                    "description": "Valores de la opción en orden."
                                },
                                "id": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "ID de la opción."
                                }
                            },
                            "required": [
                                "key",
                                "name",
                                "values"
                            ]
                        },
                        "maxItems": 10,
                        "description": "Opciones en las que difieren las variantes, como talle o color, en orden."
                    },
                    "variants": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "id": {
                                    "type": "integer",
                                    "description": "ID de la variante."
                                },
                                "archive": {
                                    "type": "boolean",
                                    "description": "true — archivar la variante en lugar de darle valores."
                                },
                                "value_indexes": {
                                    "type": "array",
                                    "items": {
                                        "type": "integer",
                                        "minimum": 0,
                                        "maximum": 49
                                    },
                                    "maxItems": 10,
                                    "description": "Valores de la variante: para cada opción, el índice del valor en options[i].values de esta solicitud, así se nombran también los valores nuevos sin id."
                                }
                            },
                            "required": [
                                "id"
                            ]
                        },
                        "maxItems": 200,
                        "description": "Distribución de cada variante vigente del producto: una combinación de valores o el archivo. Una variante que falta en la distribución se rechaza: pudo agregarse después de que leíste el producto."
                    }
                },
                "required": [
                    "options",
                    "variants"
                ]
            },
            "ReplaceVariantRecipeRequest": {
                "type": "object",
                "properties": {
                    "components": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "variant_id": {
                                    "type": "integer",
                                    "description": "ID de la variante componente: un insumo o un preelaborado de la tienda."
                                },
                                "quantity": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "maxLength": 32,
                                    "description": "Cantidad del componente por porción de un plato o por tanda de un preelaborado, como texto decimal en la unidad del componente (stock_unit de su producto); null — a gusto: el componente figura pero no se descuenta."
                                },
                                "measure_mode": {
                                    "type": "string",
                                    "enum": [
                                        "fixed",
                                        "captured",
                                        "proportional",
                                        "by_output"
                                    ],
                                    "description": "Cómo mide la producción el componente: fixed — la cantidad planificada; captured — se pesa al producir; proportional — se escala según un componente pesado. Solo lo lee la producción de preelaborados."
                                }
                            },
                            "required": [
                                "variant_id",
                                "quantity"
                            ]
                        },
                        "maxItems": 100,
                        "description": "Componentes de la receta en orden: insumos y preelaborados con su cantidad. La lista completa reemplaza la receta; una lista vacía la vacía."
                    },
                    "yield_quantity": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 32,
                        "description": "Rendimiento de una tanda de un preelaborado, como texto decimal en la unidad del preelaborado. Obligatorio en un preelaborado; null en un plato. Con puntos de control de rendimiento en los pasos de producción, los pasos fijan el rendimiento."
                    },
                    "option_recipes": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "option_id": {
                                    "type": "integer",
                                    "description": "ID de una opción por plato de los grupos de modificadores del producto."
                                },
                                "components": {
                                    "type": "array",
                                    "items": {
                                        "type": "object",
                                        "properties": {
                                            "variant_id": {
                                                "type": "integer",
                                                "description": "ID de la variante del producto."
                                            },
                                            "quantity": {
                                                "type": [
                                                    "string",
                                                    "null"
                                                ],
                                                "maxLength": 32,
                                                "description": "Cantidad del componente por un uso de la opción, como texto decimal en la unidad del componente; null — a gusto."
                                            }
                                        },
                                        "required": [
                                            "variant_id",
                                            "quantity"
                                        ]
                                    },
                                    "maxItems": 100,
                                    "description": "Qué consume la opción cuando se toma con esta variante: insumos y preelaborados con su cantidad."
                                }
                            },
                            "required": [
                                "option_id",
                                "components"
                            ]
                        },
                        "maxItems": 50,
                        "uniqueItems": true,
                        "description": "Cantidades de las opciones por plato (recipe_per_variant) en esta variante: un bloque por cada opción así de los grupos del producto. Componentes vacíos — sin cantidad, y la opción no se ofrece en esta variante. Al escribir, un bloque fija la cantidad de la opción completa y los componentes vacíos la quitan; las opciones que faltan en la lista y un cuerpo sin el campo quedan como están."
                    }
                },
                "required": [
                    "components"
                ]
            },
            "SetCustomerWholesalePriceListRequest": {
                "type": "object",
                "properties": {
                    "price_list_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Lista de precios mayorista del cliente; null quita la asignación: las ventas mayoristas al cliente van a precios base."
                    }
                },
                "required": [
                    "price_list_id"
                ]
            },
            "SetInventoryLevelRequest": {
                "type": "object",
                "properties": {
                    "variant_id": {
                        "type": "integer",
                        "description": "ID de la variante. Junto con location_id identifica el nivel de stock; un par que no está en la lista tiene stock cero."
                    },
                    "location_id": {
                        "type": "integer",
                        "description": "ID del local de la tienda."
                    },
                    "comment": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 500,
                        "description": "Comentario del movimiento."
                    },
                    "lot_number": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 64,
                        "description": "Lote al que va la diferencia, en una variante con lotes."
                    },
                    "expires_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date",
                        "description": "Fecha de vencimiento de un lote nuevo, en la zona horaria de la tienda."
                    },
                    "on_hand": {
                        "type": "string",
                        "pattern": "^-?\\d{1,15}(\\.\\d{1,15})?$",
                        "maxLength": 32,
                        "description": "Stock físico del local en todas sus ubicaciones, como cadena decimal en la unidad de la variante. Fijar el stock nombra y verifica este valor."
                    },
                    "expected_on_hand": {
                        "type": "string",
                        "pattern": "^-?\\d{1,15}(\\.\\d{1,15})?$",
                        "maxLength": 32,
                        "description": "El stock físico sobre el que contaste, como cadena decimal. Si el stock cambió desde entonces, la solicitud recibe 409 stock_on_hand_changed y no cambia nada."
                    }
                },
                "required": [
                    "variant_id",
                    "location_id",
                    "on_hand",
                    "expected_on_hand"
                ]
            },
            "SetOrderShipmentTrackingRequest": {
                "type": "object",
                "properties": {
                    "tracking_number": {
                        "type": "string",
                        "pattern": "^[\\p{L}\\p{N}](?:[\\p{L}\\p{N} .\\/_-]*[\\p{L}\\p{N}])?$",
                        "maxLength": 64,
                        "description": "El número en el servicio de envíos: letras y dígitos, con espacios, puntos, barras, guiones y guiones bajos adentro; hasta 64 caracteres."
                    },
                    "tracking_url": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "uri",
                        "maxLength": 500,
                        "description": "La página de seguimiento del servicio, http o https; null o sin el campo — sin enlace."
                    },
                    "carrier_name": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 100,
                        "description": "El nombre del servicio como lo verá el cliente: «Correo Argentino», «OCA»; null o sin el campo — sin nombre."
                    }
                },
                "required": [
                    "tracking_number"
                ]
            },
            "SetOrderStatusRequest": {
                "type": "object",
                "properties": {
                    "status": {
                        "type": "string",
                        "maxLength": 50,
                        "description": "Estado del pedido: un código de la lista de estados de la tienda (/v1/order-statuses). La tienda puede agregar sus propios estados; status_group da el significado permanente."
                    },
                    "comment": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 500,
                        "description": "Comentario del cambio, queda en el historial del pedido."
                    },
                    "delivery_failure_reason": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "enum": [
                            "customer_absent",
                            "refused",
                            "wrong_address",
                            "no_contact",
                            "other",
                            null
                        ],
                        "description": "Al pasar a un estado del grupo delivery_failed — por qué: customer_absent — no había nadie en la dirección; refused — el cliente rechazó el pedido; wrong_address — no se encontró la dirección; no_contact — no se pudo contactar al cliente; other — otro motivo, explicado en comment."
                    }
                },
                "required": [
                    "status"
                ]
            },
            "SetPriceListItemsRequest": {
                "type": "object",
                "properties": {
                    "items": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "variant_id": {
                                    "type": "integer",
                                    "description": "ID de la variante (/v1/variants). La gift card y el plan de comidas no tienen precio de local."
                                },
                                "price": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "minimum": 1,
                                    "maximum": 10000000000,
                                    "description": "Precio en unidades menores de la moneda de la tienda, mayor que cero, para una fila con precio en la moneda de la tienda: list_price_currency de la fila es null; en una fila nueva, la de la variante."
                                },
                                "compare_at_price": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "minimum": 1,
                                    "maximum": 10000000000,
                                    "description": "Precio anterior en la moneda de la tienda, mayor que price; null o sin el campo, no hay. Las listas mayoristas no lo tienen."
                                },
                                "list_price": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "minimum": 1,
                                    "maximum": 10000000000,
                                    "description": "Precio en unidades menores de la moneda de la lista, mayor que cero, para una fila con precio en esa moneda (list_price_currency de la fila; en una fila nueva, la de la variante). El precio en la moneda de la tienda lo calcula el sistema según la cotización."
                                },
                                "list_compare_at_price": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "minimum": 1,
                                    "maximum": 10000000000,
                                    "description": "Precio anterior en la moneda de la lista, mayor que list_price; null o sin el campo, no hay. Las listas mayoristas no lo tienen."
                                }
                            },
                            "required": [
                                "variant_id"
                            ]
                        },
                        "minItems": 1,
                        "maxItems": 1000,
                        "uniqueItems": true,
                        "description": "Precios fijos, hasta 1000 por solicitud, cada variante una vez. Una fila existente recibe el precio nuevo; el lote se escribe entero o no se escribe."
                    }
                },
                "required": [
                    "items"
                ]
            },
            "SetPriceListModifierItemsRequest": {
                "type": "object",
                "properties": {
                    "items": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "modifier_option_id": {
                                    "type": "integer",
                                    "description": "ID de la opción de modificador (/v1/modifier-groups)."
                                },
                                "variant_id": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "Variante con recargo propio; null o sin el campo, para todas las variantes del producto. El producto de la variante tiene que ofrecer la opción."
                                },
                                "price_delta": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "minimum": -10000000000,
                                    "maximum": 10000000000,
                                    "description": "Recargo en unidades menores de la moneda de la tienda, puede ser negativo, para una fila en la moneda de la tienda: list_price_currency de la fila es null; en una fila nueva, la de la opción."
                                },
                                "list_price_delta": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "minimum": -10000000000,
                                    "maximum": 10000000000,
                                    "description": "Recargo en unidades menores de la moneda de la lista, puede ser negativo, para una fila en esa moneda. El importe en la moneda de la tienda lo calcula el sistema según la cotización."
                                }
                            },
                            "required": [
                                "modifier_option_id"
                            ]
                        },
                        "minItems": 1,
                        "maxItems": 1000,
                        "description": "Recargos fijos, hasta 1000 por solicitud, cada par de opción y variante una vez. Una fila existente recibe el recargo nuevo; el lote se escribe entero o no se escribe."
                    }
                },
                "required": [
                    "items"
                ]
            },
            "SettlementAgreement": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID del registro, único entre los registros de su tipo en la tienda."
                    },
                    "kind": {
                        "type": "string",
                        "enum": [
                            "bilateral",
                            "tripartite"
                        ],
                        "description": "bilateral: compensación bilateral, el proveedor y el cliente son la misma persona; tripartite: compensación tripartita, la deuda del cliente se compensa con la deuda de la tienda con otra persona, el proveedor, con el acuerdo de las tres partes."
                    },
                    "legal_entity_id": {
                        "type": "integer",
                        "description": "Razón social de la tienda que es parte del acuerdo (/v1/legal-entities)."
                    },
                    "supplier_id": {
                        "type": "integer",
                        "description": "ID del proveedor acreedor (/v1/suppliers)."
                    },
                    "customer_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID del cliente deudor (/v1/customers); null si el cliente fue borrado. Solo con acceso a clientes."
                    },
                    "customer_name": {
                        "type": "string",
                        "description": "Nombre del cliente al crear el acuerdo. Solo con acceso a clientes."
                    },
                    "reference": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Número del acuerdo firmado; null si no se cargó."
                    },
                    "signed_on": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date",
                        "description": "Fecha de firma, AAAA-MM-DD; null si no se cargó."
                    },
                    "valid_from": {
                        "type": "string",
                        "description": "Inicio de la vigencia, AAAA-MM-DD."
                    },
                    "valid_until": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Fin de la vigencia, AAAA-MM-DD inclusive; null: sin vencimiento."
                    },
                    "schedule": {
                        "type": "string",
                        "enum": [
                            "manual",
                            "weekly",
                            "monthly"
                        ],
                        "description": "Compensación periódica: manual, solo a mano; weekly, una vez por semana; monthly, una vez por mes."
                    },
                    "schedule_day": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Día de la corrida: en weekly, el día de la semana ISO (1, lunes); en monthly, el día del mes 1–31 (en un mes más corto, el último); null en manual."
                    },
                    "next_run_on": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date",
                        "description": "Fecha de la próxima compensación periódica, AAAA-MM-DD en la zona horaria de la tienda; null: no habrá más corridas."
                    },
                    "note": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Nota del personal; null si no hay."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo se creó el registro."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo cambió el registro por última vez."
                    }
                },
                "required": [
                    "id",
                    "kind",
                    "legal_entity_id",
                    "supplier_id",
                    "reference",
                    "signed_on",
                    "valid_from",
                    "valid_until",
                    "schedule",
                    "schedule_day",
                    "next_run_on",
                    "note",
                    "created_at",
                    "updated_at"
                ]
            },
            "SettlementOffset": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID del registro, único entre los registros de su tipo en la tienda."
                    },
                    "number": {
                        "type": "string",
                        "description": "Número del documento de compensación."
                    },
                    "status": {
                        "type": "string",
                        "enum": [
                            "posted",
                            "voided"
                        ],
                        "description": "posted: registrada; voided: anulada, se quitaron las cancelaciones que creó la compensación y las deudas vuelven a estar abiertas."
                    },
                    "kind": {
                        "type": "string",
                        "enum": [
                            "bilateral",
                            "tripartite"
                        ],
                        "description": "bilateral: compensación bilateral; tripartite: tripartita, según el acuerdo agreement_id."
                    },
                    "legal_entity_id": {
                        "type": "integer",
                        "description": "Razón social de la tienda que registró la compensación (/v1/legal-entities)."
                    },
                    "supplier_id": {
                        "type": "integer",
                        "description": "ID del proveedor (/v1/suppliers)."
                    },
                    "agreement_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID del acuerdo de compensación (/v1/settlement-agreements); null en una compensación bilateral sin acuerdo."
                    },
                    "customer_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID del cliente (/v1/customers); null si el cliente fue borrado. Solo con acceso a clientes."
                    },
                    "customer_name": {
                        "type": "string",
                        "description": "Nombre del cliente al registrar la compensación. Solo con acceso a clientes."
                    },
                    "occurred_on": {
                        "type": "string",
                        "format": "date",
                        "description": "Fecha de la compensación, AAAA-MM-DD en la zona horaria de la tienda."
                    },
                    "total": {
                        "type": "integer",
                        "description": "Importe de la compensación: se compensa lo mismo contra las deudas del cliente y contra los comprobantes del proveedor."
                    },
                    "currency": {
                        "type": "string",
                        "enum": [
                            "ARS",
                            "USD",
                            "BRL",
                            "CLP",
                            "COP",
                            "MXN",
                            "PEN",
                            "RUB"
                        ],
                        "description": "Moneda de los importes, código ISO 4217: la moneda de la tienda."
                    },
                    "note": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Nota del personal; null si no hay."
                    },
                    "posted_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo se registró la compensación."
                    },
                    "voided_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Cuándo se anuló la compensación; null si está registrada."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo se creó el registro."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo cambió el registro por última vez."
                    }
                },
                "required": [
                    "id",
                    "number",
                    "status",
                    "kind",
                    "legal_entity_id",
                    "supplier_id",
                    "agreement_id",
                    "occurred_on",
                    "total",
                    "currency",
                    "note",
                    "posted_at",
                    "voided_at",
                    "created_at",
                    "updated_at"
                ]
            },
            "SettlementOffsetLine": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID del registro, único entre los registros de su tipo en la tienda."
                    },
                    "settlement_offset_id": {
                        "type": "integer",
                        "description": "ID de la compensación (/v1/settlement-offsets)."
                    },
                    "side": {
                        "type": "string",
                        "enum": [
                            "receivable",
                            "payable"
                        ],
                        "description": "receivable: deuda del cliente con la tienda (un pedido o la deuda de la cuenta corriente); payable: deuda de la tienda con el proveedor (un comprobante)."
                    },
                    "position": {
                        "type": "integer",
                        "description": "Posición en el orden: la menor va primero."
                    },
                    "amount": {
                        "type": "integer",
                        "description": "Importe compensado."
                    },
                    "currency": {
                        "type": "string",
                        "enum": [
                            "ARS",
                            "USD",
                            "BRL",
                            "CLP",
                            "COP",
                            "MXN",
                            "PEN",
                            "RUB"
                        ],
                        "description": "Moneda de los importes, código ISO 4217: la moneda de la tienda."
                    },
                    "order_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID del pedido cuya deuda se compensó (/v1/orders); null en las demás líneas."
                    },
                    "customer_account_entry_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID del movimiento de tipo offset de la cuenta corriente con el que la compensación redujo la deuda del cliente (/v1/customer-account-entries); null en las demás líneas. Al anularla se registra su reversión."
                    },
                    "payment_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID del pago del pedido que creó la compensación (/v1/payments); null en las demás líneas y después de anularla."
                    },
                    "supplier_bill_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID del comprobante de proveedor (/v1/supplier-bills); null en las líneas del cliente. Si la deuda por entrega se reemplazó por una factura, la factura."
                    },
                    "supplier_bill_payment_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID del pago del comprobante que creó la compensación (/v1/supplier-bill-payments); null en las líneas del cliente y después de anularla."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo se creó el registro."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo cambió el registro por última vez."
                    }
                },
                "required": [
                    "id",
                    "settlement_offset_id",
                    "side",
                    "position",
                    "amount",
                    "currency",
                    "order_id",
                    "customer_account_entry_id",
                    "payment_id",
                    "supplier_bill_id",
                    "supplier_bill_payment_id",
                    "created_at",
                    "updated_at"
                ]
            },
            "StockMovement": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID del registro, único entre los registros de su tipo en la tienda."
                    },
                    "variant_id": {
                        "type": "integer",
                        "description": "ID de la variante del producto (/v1/variants)."
                    },
                    "location_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Local del movimiento (/v1/locations); null en un movimiento del diario anterior a los locales, que solo ve una app sin límite de locales."
                    },
                    "lot_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID del lote (/v1/lots); null en un producto sin lotes."
                    },
                    "quantity": {
                        "type": "string",
                        "description": "Cambio con signo del stock físico del local, como string decimal en la unidad de la variante: mayor que cero entró, menor que cero salió. La suma por par variante × local es su on_hand."
                    },
                    "on_hand_after": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Stock físico del local después del movimiento — el mismo que on_hand del nivel de stock, como string decimal; null en un movimiento del diario anterior a los locales."
                    },
                    "reason": {
                        "type": "string",
                        "enum": [
                            "order_reserve",
                            "order_release",
                            "restock",
                            "refund_restock",
                            "return_restock",
                            "pos_tab_round",
                            "order_edit",
                            "spoilage",
                            "short_pick",
                            "manual_adjust",
                            "shrinkage",
                            "internal_use",
                            "type_change_writeoff",
                            "prep_consumption_writeoff",
                            "unit_merge",
                            "measure_basis_change",
                            "piece_reweigh",
                            "piece_shrinkage",
                            "external_inbound",
                            "external_reconcile",
                            "receipt_void",
                            "receipt_correction",
                            "supplier_return",
                            "supplier_return_void",
                            "supplier_return_correction",
                            "import_revert",
                            "lot_relabel",
                            "stocktake",
                            "bin_transfer",
                            "location_transfer",
                            "group_transfer_out",
                            "group_transfer_in",
                            "group_transfer_return",
                            "production_consume",
                            "production_output",
                            "production_void",
                            "restock_void",
                            "spoilage_void",
                            "shrinkage_void",
                            "internal_use_void",
                            "manual_adjust_void",
                            "short_pick_void"
                        ],
                        "description": "Motivo del movimiento — la lista completa de stock. Conviene agrupar por category: un motivo nuevo llega en una de las columnas conocidas."
                    },
                    "category": {
                        "type": "string",
                        "enum": [
                            "sale",
                            "receipt",
                            "external",
                            "production_output",
                            "production_consume",
                            "spoilage",
                            "shrinkage",
                            "internal_use",
                            "stocktake",
                            "correction",
                            "supplier_return",
                            "transfer",
                            "group_transfer",
                            "technical"
                        ],
                        "description": "Columna del libro de existencias: sale — venta y sus devoluciones; receipt — recepción y su reversión; external — importación y conciliación con un sistema externo; production_output y production_consume — producción y consumo; spoilage — merma; shrinkage — faltante; internal_use — consumo propio; stocktake — diferencia de inventario; correction — corrección del registro; supplier_return — devolución a proveedor; transfer — reubicación y traslado; group_transfer — traslado entre tiendas del grupo, al costo; technical — cambio de unidad de stock."
                    },
                    "document": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "properties": {
                            "type": {
                                "type": "string",
                                "enum": [
                                    "goods_receipt",
                                    "stocktake",
                                    "stock_write_off",
                                    "production_order",
                                    "location_transfer",
                                    "group_transfer",
                                    "supplier_return",
                                    "order"
                                ],
                                "description": "Tipo de documento: goods_receipt — recepción (/v1/goods-receipts); stocktake — inventario (/v1/stocktakes); stock_write_off — acta de baja; production_order — acta de producción; location_transfer — traslado entre locales (/v1/location-transfers); group_transfer — traslado entre tiendas del grupo, la copia de esta tienda; supplier_return — devolución a proveedor (/v1/supplier-returns); order — pedido (/v1/orders). El movimiento de un pedido dentro de un acta pertenece al acta."
                            },
                            "id": {
                                "type": "integer",
                                "description": "ID del documento."
                            }
                        },
                        "required": [
                            "type",
                            "id"
                        ],
                        "description": "Documento primario del movimiento; null en una corrección manual, un picking o un movimiento técnico."
                    },
                    "write_off_reason_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID del motivo de baja (/v1/write-off-reasons); null en los demás movimientos."
                    },
                    "reverses_movement_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID del movimiento que este revierte; null en un movimiento común."
                    },
                    "posting_id": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Asiento: un UUID común a todos los movimientos de una operación; null en un movimiento anterior a los asientos."
                    },
                    "comment": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Comentario del personal en una corrección manual; null si no hay."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo se creó el registro."
                    }
                },
                "required": [
                    "id",
                    "variant_id",
                    "location_id",
                    "lot_id",
                    "quantity",
                    "on_hand_after",
                    "reason",
                    "category",
                    "document",
                    "write_off_reason_id",
                    "reverses_movement_id",
                    "posting_id",
                    "comment",
                    "created_at"
                ]
            },
            "Stocktake": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID del registro, único entre los registros de su tipo en la tienda."
                    },
                    "number": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Número del inventario en la tienda."
                    },
                    "location_id": {
                        "type": "integer",
                        "description": "ID del local inventariado (/v1/locations)."
                    },
                    "status": {
                        "type": "string",
                        "enum": [
                            "draft",
                            "committing",
                            "committed",
                            "voided"
                        ],
                        "description": "draft — el conteo está en curso; committing — los ajustes se escriben en segundo plano; committed — registrado, los ajustes son movimientos de stock con document.type = stocktake; voided — el borrador se anuló, no hay movimientos. Un registro fallido devuelve el inventario a draft."
                    },
                    "blind": {
                        "type": "boolean",
                        "description": "Conteo ciego: mientras el inventario es borrador, el esperado y la diferencia de sus líneas son null."
                    },
                    "coverage": {
                        "type": "object",
                        "properties": {
                            "type": {
                                "type": "string",
                                "enum": [
                                    "full",
                                    "category",
                                    "selection"
                                ],
                                "description": "full — todo el local; category — las categorías elegidas; selection — los artículos agregados durante el conteo."
                            },
                            "category_ids": {
                                "type": [
                                    "array",
                                    "null"
                                ],
                                "items": {
                                    "type": "integer"
                                },
                                "description": "ID de las categorías (/v1/categories) en el alcance category; en los demás, null."
                            }
                        },
                        "required": [
                            "type",
                            "category_ids"
                        ],
                        "description": "Qué se cuenta."
                    },
                    "note": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Nota del inventario; null si no la hay."
                    },
                    "submitted_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Cuándo quien contó pasó el inventario a registro; null si no lo pasó."
                    },
                    "committed_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Cuándo se aplicaron los ajustes; null si el inventario no está registrado."
                    },
                    "voided_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Cuándo se anuló el borrador; null si no se anuló."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo se creó el registro."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo cambió el registro por última vez."
                    }
                },
                "required": [
                    "id",
                    "number",
                    "location_id",
                    "status",
                    "blind",
                    "coverage",
                    "note",
                    "submitted_at",
                    "committed_at",
                    "voided_at",
                    "created_at",
                    "updated_at"
                ]
            },
            "StocktakeLine": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID del registro, único entre los registros de su tipo en la tienda."
                    },
                    "stocktake_id": {
                        "type": "integer",
                        "description": "ID del inventario (/v1/stocktakes)."
                    },
                    "variant_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID de la variante del producto (/v1/variants). null — el artículo se borró del catálogo antes de que las líneas de inventario lo retuvieran (noviembre de 2026); esa línea no tiene cantidades."
                    },
                    "lot_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID del lote (/v1/lots); null — eje sin lote. En un local con ubicaciones el artículo tiene una línea por ubicación y lote: su suma es la cifra del local."
                    },
                    "expected": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Stock contable del eje en el momento del conteo, como cadena decimal en la unidad de la variante: la base de la diferencia. null en un conteo ciego mientras es borrador."
                    },
                    "counted": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Cantidad contada en el eje; null — todavía no se contó, y el registro no toca esa línea."
                    },
                    "variance": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Diferencia: counted menos expected. null mientras la línea no está contada o el stock contable está oculto."
                    },
                    "adjustment": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Ajuste aplicado por el registro, con signo. Puede diferir de variance: no incluye las ventas entre el conteo y el registro ni los paquetes fraccionados reservados por pedidos. null antes del registro."
                    },
                    "on_hand_after": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Stock físico del artículo en el local justo después del registro: el mismo en todas las líneas del artículo. null antes del registro y en una línea omitida."
                    },
                    "skip_reason": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "enum": [
                            "variant_deleted",
                            "not_tracked",
                            null
                        ],
                        "description": "Por qué el registro omitió una línea contada: variant_deleted — se borró el artículo; not_tracked — se desactivó el control de stock del artículo. null — la línea no se omitió."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo se creó el registro."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo cambió el registro por última vez."
                    }
                },
                "required": [
                    "id",
                    "stocktake_id",
                    "variant_id",
                    "lot_id",
                    "expected",
                    "counted",
                    "variance",
                    "adjustment",
                    "on_hand_after",
                    "skip_reason",
                    "created_at",
                    "updated_at"
                ]
            },
            "Store": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID de la tienda."
                    },
                    "name": {
                        "type": "object",
                        "additionalProperties": {
                            "type": "string"
                        },
                        "description": "Nombre de la tienda por idioma."
                    },
                    "currency": {
                        "type": "string",
                        "description": "Moneda de la tienda, código ISO 4217. Todo importe de la API es un entero en sus unidades mínimas: centavos para USD, ARS o BRL, pesos enteros para CLP."
                    },
                    "timezone": {
                        "type": "string",
                        "description": "Zona horaria de la tienda, nombre IANA. Las fechas de calendario de la API, como reopens_on, son fechas en esta zona."
                    },
                    "country": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "País de la tienda, código ISO 3166-1 alfa-2; null si no está definido."
                    },
                    "default_locale": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Idioma principal del contenido de la tienda; null si no está definido."
                    },
                    "supported_locales": {
                        "type": "array",
                        "items": {
                            "type": "string"
                        },
                        "description": "Idiomas en los que la tienda completa su contenido."
                    },
                    "marketing_consent_mode": {
                        "type": "string",
                        "enum": [
                            "opt_out",
                            "opt_in"
                        ],
                        "description": "Qué consentimiento a los mensajes de marketing le basta a la tienda: opt_out — todos los que no se dieron de baja; opt_in — solo los clientes que aceptaron de forma explícita (marketing_consents del cliente). WhatsApp siempre requiere consentimiento explícito."
                    }
                },
                "required": [
                    "id",
                    "name",
                    "currency",
                    "timezone",
                    "country",
                    "default_locale",
                    "supported_locales",
                    "marketing_consent_mode"
                ]
            },
            "Supplier": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID del registro, único entre los registros de su tipo en la tienda."
                    },
                    "version": {
                        "type": "integer",
                        "description": "Versión del registro: crece con cada cambio. Para cambiar el registro, envíela como ETag en If-Match."
                    },
                    "external_id": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "ID externo: el ID del registro en tu sistema; null si la aplicación no lo fijó. Cada aplicación ve solo sus propios ID."
                    },
                    "name": {
                        "type": "string",
                        "description": "Nombre del proveedor como lo ve la tienda."
                    },
                    "legal_name": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Razón social; null si no está cargada."
                    },
                    "tax_id": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Número fiscal como lo cargó la tienda (CUIT en Argentina); null si no está cargado."
                    },
                    "tax_id_country": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "País del número fiscal, ISO 3166-1 alfa-2; null si el número no está cargado."
                    },
                    "is_active": {
                        "type": "boolean",
                        "description": "false: el proveedor está desactivado; no se le hacen pedidos nuevos y los documentos quedan."
                    },
                    "currency": {
                        "type": "string",
                        "description": "Moneda de compra con el proveedor, ISO 4217: en ella están min_order_amount y los precios de sus pedidos."
                    },
                    "payment_term_days": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Plazo de pago en días: con él se calcula el vencimiento due_on del comprobante. null: sin plazo."
                    },
                    "prices_include_tax": {
                        "type": [
                            "boolean",
                            "null"
                        ],
                        "description": "true: el proveedor cotiza con impuestos; false: sin impuestos; null: según la regla de la tienda."
                    },
                    "settlement_mode": {
                        "type": "string",
                        "enum": [
                            "on_receipt",
                            "on_sale"
                        ],
                        "description": "on_receipt: compra común, la deuda nace con la recepción; on_sale: consignación, la tienda paga lo vendido según la liquidación de consignación."
                    },
                    "consignment_loss_policy": {
                        "type": "string",
                        "enum": [
                            "return_to_supplier",
                            "our_cost"
                        ],
                        "description": "Quién paga la mercadería en consignación vencida o faltante: return_to_supplier: a cargo del proveedor, con devolución de la mercadería; our_cost: pérdida de la tienda."
                    },
                    "lead_time_days": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Plazo de entrega en días desde el pedido; null si no está cargado."
                    },
                    "min_order_amount": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Monto mínimo de pedido en unidades mínimas de currency; null: sin mínimo."
                    },
                    "customer_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID de la misma contraparte como cliente (/v1/customers): con él la tienda compensa deudas cruzadas. null si no hay vínculo. Solo con acceso a clientes."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo se creó el registro."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo cambió el registro por última vez."
                    }
                },
                "required": [
                    "id",
                    "version",
                    "external_id",
                    "name",
                    "legal_name",
                    "tax_id",
                    "tax_id_country",
                    "is_active",
                    "currency",
                    "payment_term_days",
                    "prices_include_tax",
                    "settlement_mode",
                    "consignment_loss_policy",
                    "lead_time_days",
                    "min_order_amount",
                    "created_at",
                    "updated_at"
                ]
            },
            "SupplierBalance": {
                "type": "object",
                "properties": {
                    "supplier_id": {
                        "type": "integer",
                        "description": "ID del proveedor (/v1/suppliers)."
                    },
                    "legal_entity_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Razón social de la tienda a la que se limita el saldo; null: todas."
                    },
                    "as_of": {
                        "type": "string",
                        "description": "Día de la tienda para el que se abre el vencido, AAAA-MM-DD."
                    },
                    "currency": {
                        "type": "string",
                        "enum": [
                            "ARS",
                            "USD",
                            "BRL",
                            "CLP",
                            "COP",
                            "MXN",
                            "PEN",
                            "RUB"
                        ],
                        "description": "Moneda de los importes, código ISO 4217: la moneda de la tienda."
                    },
                    "total_due": {
                        "type": "integer",
                        "description": "Total de la deuda: bills_outstanding + settled_pending_bill + accrued_unsettled + received_unbilled − returns_expected − advances_unapplied − payments_unapplied."
                    },
                    "has_open_items": {
                        "type": "boolean",
                        "description": "Si hay partidas abiertas: el total puede ser cero cuando se compensan entre sí."
                    },
                    "bills_outstanding": {
                        "type": "integer",
                        "description": "Comprobantes registrados sin cancelar: lo que se puede pagar ahora; las notas de crédito lo reducen."
                    },
                    "overdue": {
                        "type": "integer",
                        "description": "Parte de bills_outstanding vencida; por antigüedad del vencimiento se abre en overdue_1_30, overdue_31_60, overdue_61_90 y overdue_90_plus, que suman overdue."
                    },
                    "overdue_1_30": {
                        "type": "integer",
                        "description": "Tramo de antigüedad del vencimiento de overdue; sus límites en días del calendario de la tienda están en el nombre del campo."
                    },
                    "overdue_31_60": {
                        "type": "integer",
                        "description": "Tramo de antigüedad del vencimiento de overdue; sus límites en días del calendario de la tienda están en el nombre del campo."
                    },
                    "overdue_61_90": {
                        "type": "integer",
                        "description": "Tramo de antigüedad del vencimiento de overdue; sus límites en días del calendario de la tienda están en el nombre del campo."
                    },
                    "overdue_90_plus": {
                        "type": "integer",
                        "description": "Último tramo de antigüedad del vencimiento de overdue: todo lo anterior a overdue_61_90."
                    },
                    "not_due": {
                        "type": "integer",
                        "description": "Parte de bills_outstanding que todavía no vence (hoy o después)."
                    },
                    "due_soon": {
                        "type": "integer",
                        "description": "Parte de not_due que vence en la próxima semana."
                    },
                    "no_due_date": {
                        "type": "integer",
                        "description": "Parte de bills_outstanding sin vencimiento."
                    },
                    "settled_pending_bill": {
                        "type": "integer",
                        "description": "Reconocido por una liquidación de consignación, todavía sin comprobante registrado."
                    },
                    "accrued_unsettled": {
                        "type": "integer",
                        "description": "Vendido en consignación y todavía sin liquidar."
                    },
                    "received_unbilled": {
                        "type": "integer",
                        "description": "Recibido en entregas que no cubre ningún comprobante registrado: deuda sin documento."
                    },
                    "returns_expected": {
                        "type": "integer",
                        "description": "Reclamo por devoluciones despachadas todavía sin compensar; reduce la deuda."
                    },
                    "advances_unapplied": {
                        "type": "integer",
                        "description": "Anticipos de órdenes de compra todavía sin aplicar a comprobantes; reducen la deuda."
                    },
                    "payments_unapplied": {
                        "type": "integer",
                        "description": "Pagos del libro de dinero todavía sin aplicar a comprobantes, menos el dinero que devolvió el proveedor; reducen la deuda."
                    }
                },
                "required": [
                    "supplier_id",
                    "legal_entity_id",
                    "as_of",
                    "currency",
                    "total_due",
                    "has_open_items",
                    "bills_outstanding",
                    "overdue",
                    "overdue_1_30",
                    "overdue_31_60",
                    "overdue_61_90",
                    "overdue_90_plus",
                    "not_due",
                    "due_soon",
                    "no_due_date",
                    "settled_pending_bill",
                    "accrued_unsettled",
                    "received_unbilled",
                    "returns_expected",
                    "advances_unapplied",
                    "payments_unapplied"
                ]
            },
            "SupplierBill": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID del registro, único entre los registros de su tipo en la tienda."
                    },
                    "version": {
                        "type": "integer",
                        "description": "Versión del registro: crece con cada cambio. Para cambiar el registro, envíela como ETag en If-Match."
                    },
                    "kind": {
                        "type": "string",
                        "enum": [
                            "invoice",
                            "debit_note",
                            "credit_note"
                        ],
                        "description": "invoice: factura; debit_note: nota de débito, aumenta la deuda; credit_note: nota de crédito, reduce la deuda (devolución, descuento, corrección). Los importes del comprobante son siempre positivos y el signo lo da kind."
                    },
                    "status": {
                        "type": "string",
                        "enum": [
                            "draft",
                            "posted",
                            "void"
                        ],
                        "description": "draft: borrador, no entra en la contabilidad; posted: registrado, entra en cuentas a pagar y en el libro de compras y no cambia; void: anulado, no entra en nada."
                    },
                    "fiscal": {
                        "type": "boolean",
                        "description": "false: deuda por una entrega sin factura, sin datos de ARCA y fuera del libro de compras; true: factura o nota."
                    },
                    "legal_entity_id": {
                        "type": "integer",
                        "description": "ID de la razón social compradora de la tienda (/v1/legal-entities)."
                    },
                    "supplier_id": {
                        "type": "integer",
                        "description": "ID del proveedor (/v1/suppliers)."
                    },
                    "related_bill_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID del comprobante que corrige la nota; null en una factura y en una nota sin referencia."
                    },
                    "number": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Número del comprobante como lo cargó la tienda; null en una deuda sin factura."
                    },
                    "issued_on": {
                        "type": "string",
                        "format": "date",
                        "description": "Fecha del comprobante, YYYY-MM-DD en la zona horaria de la tienda."
                    },
                    "tax_period": {
                        "type": "string",
                        "description": "Período fiscal en el que el comprobante va al libro de compras, YYYY-MM."
                    },
                    "due_on": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date",
                        "description": "Vencimiento, YYYY-MM-DD en la zona horaria de la tienda; null: sin vencimiento."
                    },
                    "currency": {
                        "type": "string",
                        "description": "Moneda del comprobante, ISO 4217: en ella están todos los importes salvo base_total."
                    },
                    "exchange_rate": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Cotización de la moneda del comprobante a la de la tienda como cadena decimal; null en un comprobante en la moneda de la tienda."
                    },
                    "net_taxed": {
                        "type": "integer",
                        "description": "Neto gravado de IVA."
                    },
                    "net_exempt": {
                        "type": "integer",
                        "description": "Importe exento de IVA."
                    },
                    "net_untaxed": {
                        "type": "integer",
                        "description": "Importe no gravado de IVA."
                    },
                    "tax_total": {
                        "type": "integer",
                        "description": "IVA del comprobante."
                    },
                    "perceptions_total": {
                        "type": "integer",
                        "description": "Percepciones: importes que el proveedor sumó al pago a cuenta de impuestos futuros de la tienda."
                    },
                    "other_taxes_total": {
                        "type": "integer",
                        "description": "Impuestos internos y otros tributos del comprobante."
                    },
                    "total": {
                        "type": "integer",
                        "description": "Total del comprobante: neto, impuestos y percepciones."
                    },
                    "base_total": {
                        "type": "integer",
                        "description": "Total en la moneda de la tienda a la cotización del comprobante."
                    },
                    "paid_total": {
                        "type": "integer",
                        "description": "Cuánto se canceló en la moneda del documento: con dinero, compensación, nota de crédito, anticipo, pago del libro o fuera del sistema. Cada cancelación mueve el comprobante en el feed."
                    },
                    "outstanding": {
                        "type": "integer",
                        "description": "Parte pendiente en la moneda del documento: total − paid_total. En una nota de crédito, el crédito sin aplicar; negativo si el documento está pagado de más."
                    },
                    "tax_lines": {
                        "type": [
                            "array",
                            "null"
                        ],
                        "items": {
                            "$ref": "#/components/schemas/TaxLine"
                        },
                        "description": "IVA por alícuota: gravado, exento y no gravado. null: el comprobante no tiene impuesto o no se puede determinar la alícuota de la parte gravada."
                    },
                    "additional_taxes": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "kind": {
                                    "type": "string",
                                    "enum": [
                                        "perception",
                                        "withholding",
                                        "internal",
                                        "other"
                                    ],
                                    "description": "perception: percepción, aumenta el importe a pagar y la tienda la computa; withholding: retención, la tienda la retiene al pagar y la ingresa al fisco, el importe transferido baja; internal: impuestos internos; other: otros tributos."
                                },
                                "regime": {
                                    "type": "string",
                                    "enum": [
                                        "vat",
                                        "income",
                                        "turnover",
                                        "municipal",
                                        "internal",
                                        "social",
                                        "other"
                                    ],
                                    "description": "Qué impuesto: vat: IVA; income: Ganancias; turnover: Ingresos Brutos; municipal: tasas municipales, y otros."
                                },
                                "jurisdiction": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "description": "Jurisdicción del impuesto, por ejemplo la provincia de Ingresos Brutos; null si el impuesto no la necesita."
                                },
                                "amount": {
                                    "type": "integer",
                                    "description": "Importe del impuesto."
                                },
                                "certificate_number": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "description": "Número del certificado de retención o percepción; null si no hay."
                                }
                            },
                            "required": [
                                "kind",
                                "regime",
                                "jurisdiction",
                                "amount",
                                "certificate_number"
                            ]
                        },
                        "description": "Impuestos además del IVA: percepciones, retenciones, internos y otros. El comprobante solo trae su importe, sin base ni alícuota."
                    },
                    "lines": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "description": {
                                    "type": "string",
                                    "description": "Descripción de la línea como en el comprobante."
                                },
                                "variant_id": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "ID de la variante del producto (/v1/variants); null en una línea que no es de un producto."
                                },
                                "quantity": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "description": "Cantidad como cadena decimal; null si no figura."
                                },
                                "unit_amount": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "Precio unitario sin impuestos; null si no figura."
                                },
                                "net_amount": {
                                    "type": "integer",
                                    "description": "Importe de la línea sin impuestos."
                                },
                                "tax_kind": {
                                    "type": "string",
                                    "enum": [
                                        "taxed",
                                        "exempt",
                                        "untaxed"
                                    ],
                                    "description": "taxed: gravado a una alícuota; exempt: exento; untaxed: no gravado."
                                },
                                "rate_bps": {
                                    "type": "integer",
                                    "description": "Alícuota de IVA en puntos básicos: 2100 es 21 %."
                                },
                                "tax_amount": {
                                    "type": "integer",
                                    "description": "IVA de la línea."
                                }
                            },
                            "required": [
                                "description",
                                "variant_id",
                                "quantity",
                                "unit_amount",
                                "net_amount",
                                "tax_kind",
                                "rate_bps",
                                "tax_amount"
                            ]
                        },
                        "description": "Líneas del comprobante en orden; un comprobante cargado por totales no tiene líneas."
                    },
                    "vendor": {
                        "type": "object",
                        "properties": {
                            "tax_id": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "description": "Número fiscal del proveedor en el comprobante; null si no figura."
                            },
                            "legal_name": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "description": "Razón social del proveedor en el comprobante; null si no figura."
                            }
                        },
                        "required": [
                            "tax_id",
                            "legal_name"
                        ],
                        "description": "Datos del proveedor como figuran en el comprobante: no cambian si después se corrige la ficha del proveedor."
                    },
                    "goods_receipt_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID de la recepción que generó esta deuda por entrega; null si el comprobante no lo generó una recepción."
                    },
                    "goods_receipt_ids": {
                        "type": "array",
                        "items": {
                            "type": "integer"
                        },
                        "description": "Recepciones que cubre el documento (/v1/goods-receipts): entregas conciliadas con la factura o la entrega de una deuda por entrega."
                    },
                    "purchase_order_ids": {
                        "type": "array",
                        "items": {
                            "type": "integer"
                        },
                        "description": "Órdenes de compra a las que corresponde el documento (/v1/purchase-orders)."
                    },
                    "supplier_return_ids": {
                        "type": "array",
                        "items": {
                            "type": "integer"
                        },
                        "description": "Devoluciones a proveedores por las que se emitió la nota de crédito (/v1/supplier-returns)."
                    },
                    "consignment_settlement_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID de la liquidación de consignación por la que se emitió el comprobante; null en los demás."
                    },
                    "match_status": {
                        "type": "string",
                        "enum": [
                            "unmatched",
                            "matched",
                            "flagged"
                        ],
                        "description": "Control contra la recepción: unmatched: sin recepción vinculada; matched: vinculada y coincide; flagged: vinculada con diferencias. No bloquea el pago."
                    },
                    "note": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Nota del personal; null si no hay."
                    },
                    "approved_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Cuándo se aprobó el comprobante para pago; null si no está aprobado."
                    },
                    "posted_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Cuándo se registró el comprobante; null en un borrador."
                    },
                    "voided_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Cuándo se anuló el comprobante; null si no está anulado."
                    },
                    "ar": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "properties": {
                            "document_type_code": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "description": "Código de tipo de comprobante de ARCA: 001: factura A; 006: factura B; 011: factura C; null si no figura."
                            },
                            "point_of_sale": {
                                "type": [
                                    "integer",
                                    "null"
                                ],
                                "description": "Punto de venta del proveedor; null si no figura."
                            },
                            "authorization_kind": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "enum": [
                                    "CAE",
                                    "CAEA",
                                    "CAI",
                                    null
                                ],
                                "description": "CAE: comprobante electrónico; CAEA: código otorgado por período; CAI: talonario impreso; null: sin autorización (por ejemplo, un comprobante del exterior)."
                            },
                            "authorization_code": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "description": "Código de autorización; null si no figura."
                            },
                            "authorization_expires_on": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "format": "date",
                                "description": "Vencimiento del código de autorización, YYYY-MM-DD; null si no figura."
                            },
                            "verification_status": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "enum": [
                                    "verified",
                                    "rejected",
                                    "unavailable",
                                    "pending",
                                    null
                                ],
                                "description": "Constatación del comprobante en ARCA: verified: confirmado; rejected: ARCA no lo reconoce; unavailable: no se pudo constatar; pending: espera la constatación; null: no se constató."
                            },
                            "credit_fiscal_amount": {
                                "type": [
                                    "integer",
                                    "null"
                                ],
                                "description": "Parte computable del IVA con prorrateo del crédito fiscal; null: se computa todo el impuesto."
                            },
                            "import": {
                                "type": [
                                    "object",
                                    "null"
                                ],
                                "properties": {
                                    "kind": {
                                        "type": "string",
                                        "enum": [
                                            "goods",
                                            "services"
                                        ],
                                        "description": "goods: importación de bienes con despacho; services: servicios de un prestador del exterior."
                                    },
                                    "customs_declaration": {
                                        "type": [
                                            "string",
                                            "null"
                                        ],
                                        "description": "Número de despacho de la importación de bienes; null si no se indicó."
                                    },
                                    "document_kind": {
                                        "type": [
                                            "string",
                                            "null"
                                        ],
                                        "enum": [
                                            "invoice",
                                            "contract",
                                            "other",
                                            null
                                        ],
                                        "description": "Documento del prestador: invoice (factura), contract (contrato) u other (otro, con descripción); null si no se indicó."
                                    },
                                    "document_description": {
                                        "type": [
                                            "string",
                                            "null"
                                        ],
                                        "description": "Descripción del documento de tipo other; null en los demás."
                                    },
                                    "provider_tax_id": {
                                        "type": [
                                            "string",
                                            "null"
                                        ],
                                        "description": "Identificación fiscal del prestador en su país; null si no se indicó."
                                    },
                                    "tax_paid_on": {
                                        "type": [
                                            "string",
                                            "null"
                                        ],
                                        "format": "date",
                                        "description": "Fecha de pago del IVA por la importación de servicios, YYYY-MM-DD; null si no se indicó."
                                    },
                                    "tax_paid_amount": {
                                        "type": [
                                            "integer",
                                            "null"
                                        ],
                                        "description": "IVA pagado por la importación de servicios en la moneda del documento; null si no se indicó."
                                    },
                                    "payment_reference": {
                                        "type": [
                                            "string",
                                            "null"
                                        ],
                                        "description": "Identificación del pago del impuesto; null si no se indicó."
                                    },
                                    "payment_entity_tax_id": {
                                        "type": [
                                            "string",
                                            "null"
                                        ],
                                        "description": "CUIT del banco por el que se ingresó el impuesto; null si no se indicó."
                                    }
                                },
                                "required": [
                                    "kind",
                                    "customs_declaration",
                                    "document_kind",
                                    "document_description",
                                    "provider_tax_id",
                                    "tax_paid_on",
                                    "tax_paid_amount",
                                    "payment_reference",
                                    "payment_entity_tax_id"
                                ],
                                "description": "Importación de bienes o servicios, con su propio diseño del libro de importaciones de ARCA; null en un documento local."
                            }
                        },
                        "required": [
                            "document_type_code",
                            "point_of_sale",
                            "authorization_kind",
                            "authorization_code",
                            "authorization_expires_on",
                            "verification_status",
                            "credit_fiscal_amount",
                            "import"
                        ],
                        "description": "Datos de ARCA de la factura o nota; null en una deuda por entrega sin factura."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo se creó el registro."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo cambió el registro por última vez."
                    }
                },
                "required": [
                    "id",
                    "version",
                    "kind",
                    "status",
                    "fiscal",
                    "legal_entity_id",
                    "supplier_id",
                    "related_bill_id",
                    "number",
                    "issued_on",
                    "tax_period",
                    "due_on",
                    "currency",
                    "exchange_rate",
                    "net_taxed",
                    "net_exempt",
                    "net_untaxed",
                    "tax_total",
                    "perceptions_total",
                    "other_taxes_total",
                    "total",
                    "base_total",
                    "paid_total",
                    "outstanding",
                    "tax_lines",
                    "additional_taxes",
                    "lines",
                    "vendor",
                    "goods_receipt_id",
                    "goods_receipt_ids",
                    "purchase_order_ids",
                    "supplier_return_ids",
                    "consignment_settlement_id",
                    "match_status",
                    "note",
                    "approved_at",
                    "posted_at",
                    "voided_at",
                    "ar",
                    "created_at",
                    "updated_at"
                ]
            },
            "SupplierBillPayment": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID del registro, único entre los registros de su tipo en la tienda."
                    },
                    "supplier_bill_id": {
                        "type": "integer",
                        "description": "ID del comprobante de proveedor (/v1/supplier-bills)."
                    },
                    "kind": {
                        "type": "string",
                        "enum": [
                            "money",
                            "offset",
                            "credit_note",
                            "advance",
                            "journal",
                            "out_of_band"
                        ],
                        "description": "Con qué se canceló la deuda: money: con dinero de una cuenta; offset: compensación con una deuda cruzada; credit_note: con una nota de crédito (la línea está en la factura y en la nota); advance: con el anticipo de una orden de compra; journal: con un gasto ya registrado en el libro de dinero; out_of_band: pagado fuera del sistema, sin cuenta de dinero."
                    },
                    "amount": {
                        "type": "integer",
                        "description": "Importe cancelado en la moneda del comprobante."
                    },
                    "currency": {
                        "type": "string",
                        "description": "Moneda del comprobante de proveedor, ISO 4217."
                    },
                    "withheld_amount": {
                        "type": "integer",
                        "description": "Retenido al pagar, en la moneda del comprobante; el proveedor recibió amount menos withheld_amount."
                    },
                    "money_account_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID de la cuenta de dinero (/v1/money-accounts) desde la que se pagó; null en pagos sin dinero de la tienda."
                    },
                    "account_amount": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Transferido desde la cuenta de dinero, en su moneda, como cadena decimal; null si no hay cuenta de dinero."
                    },
                    "base_amount": {
                        "type": "integer",
                        "description": "Equivalente en la moneda de la tienda a la fecha del pago."
                    },
                    "exchange_rate": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Cotización a la fecha del pago como cadena decimal; null si no hubo conversión."
                    },
                    "paid_on": {
                        "type": "string",
                        "format": "date",
                        "description": "Fecha del pago, YYYY-MM-DD en la zona horaria de la tienda."
                    },
                    "settlement_offset_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID del comprobante de compensación en kind offset; null en los demás."
                    },
                    "counterpart_bill_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID del comprobante de contrapartida en kind credit_note: en la factura, la nota; en la nota, la factura; null en los demás."
                    },
                    "purchase_order_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID de la orden de compra cuyo anticipo canceló el comprobante, en kind advance; null en los demás."
                    },
                    "money_transaction_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID del gasto del libro de dinero (/v1/money-transactions) aplicado al comprobante, en kind journal; null en los demás. El dinero de kind money es un movimiento del libro con source supplier_bill_payment y el ID de este pago."
                    },
                    "note": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Nota del personal; null si no hay."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo se creó el registro."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo cambió el registro por última vez."
                    }
                },
                "required": [
                    "id",
                    "supplier_bill_id",
                    "kind",
                    "amount",
                    "currency",
                    "withheld_amount",
                    "money_account_id",
                    "account_amount",
                    "base_amount",
                    "exchange_rate",
                    "paid_on",
                    "settlement_offset_id",
                    "counterpart_bill_id",
                    "purchase_order_id",
                    "money_transaction_id",
                    "note",
                    "created_at",
                    "updated_at"
                ]
            },
            "SupplierReturn": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID del registro, único entre los registros de su tipo en la tienda."
                    },
                    "number": {
                        "type": "string",
                        "description": "Número de la devolución."
                    },
                    "status": {
                        "type": "string",
                        "enum": [
                            "draft",
                            "shipped",
                            "closed",
                            "void"
                        ],
                        "description": "draft: borrador, el stock no se tocó y las líneas se pueden editar; shipped: enviada al proveedor, stock dado de baja, se espera la compensación; closed: cerrada, se recibió la compensación o se resolvió el rechazo; void: anulada, el stock se repuso."
                    },
                    "reason": {
                        "type": "string",
                        "enum": [
                            "defect",
                            "wrong_item",
                            "surplus",
                            "recall",
                            "expiry",
                            "other"
                        ],
                        "description": "Motivo de la devolución: defect: defectuoso; wrong_item: artículo equivocado; surplus: sobrante; recall: retiro del lote; expiry: vencido; other: otro."
                    },
                    "supplier_id": {
                        "type": "integer",
                        "description": "ID del proveedor (/v1/suppliers)."
                    },
                    "legal_entity_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Razón social de la tienda a cuyo nombre se espera la nota de crédito (/v1/legal-entities); null en devoluciones antiguas."
                    },
                    "location_id": {
                        "type": "integer",
                        "description": "Local desde donde salió la mercadería (/v1/locations)."
                    },
                    "goods_receipt_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Recepción de origen (/v1/goods-receipts); null si la devolución no tiene recepción y se valoró al costo."
                    },
                    "purchase_order_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Orden de compra (/v1/purchase-orders); null sin orden."
                    },
                    "issued_on": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date",
                        "description": "Fecha del documento: el día en la conciliación y en el papel, YYYY-MM-DD; null en un borrador."
                    },
                    "currency": {
                        "type": "string",
                        "description": "Moneda de la devolución, ISO 4217: en ella van los precios de las líneas, subtotal y settled_amount."
                    },
                    "exchange_rate": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Tipo de cambio de la moneda de la devolución a la moneda de la tienda como texto decimal, tomado al enviar; null antes del envío."
                    },
                    "subtotal": {
                        "type": "integer",
                        "description": "Valor de las líneas de la devolución en su moneda."
                    },
                    "base_subtotal": {
                        "type": "integer",
                        "description": "Valor de las líneas en la moneda de la tienda al tipo de cambio tomado."
                    },
                    "expected_settlement": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "enum": [
                            "credit_note",
                            "replacement",
                            "refund",
                            "rejected",
                            "none",
                            null
                        ],
                        "description": "Qué se espera del proveedor, se fija al enviar: credit_note: nota de crédito; replacement: reposición de mercadería; refund: dinero; none: sin compensación; null: no se fijó."
                    },
                    "settlement": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "enum": [
                            "credit_note",
                            "replacement",
                            "refund",
                            "rejected",
                            "none",
                            null
                        ],
                        "description": "Qué se recibió al cerrar: credit_note: nota de crédito; replacement: reposición; refund: dinero; rejected: el proveedor la rechazó; none: sin compensación; null: no está cerrada."
                    },
                    "settled_amount": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Monto que reconoció el proveedor, en la moneda de la devolución; null si todavía no lo reconoció."
                    },
                    "base_settled_amount": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Monto reconocido en la moneda de la tienda al tipo de cambio tomado; null si todavía no se reconoció."
                    },
                    "shipped_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Cuándo se envió la mercadería al proveedor; null en un borrador."
                    },
                    "closed_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Cuándo se cerró la devolución; null si no está cerrada."
                    },
                    "voided_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Cuándo se anuló la devolución; null en una devolución vigente."
                    },
                    "void_reason": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Por qué se anuló la devolución; null en una vigente y en documentos antiguos."
                    },
                    "note": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Nota del personal; null si no hay."
                    },
                    "lines": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "id": {
                                    "type": "integer",
                                    "description": "ID del registro, único entre los registros de su tipo en la tienda."
                                },
                                "variant_id": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "ID de la variante del producto (/v1/variants)."
                                },
                                "lot_id": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "Lote de la línea (/v1/lots); null en un producto sin lotes."
                                },
                                "goods_receipt_line_id": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "Línea de la recepción de origen (lines[].id de la recepción) de la que sale el precio; null en una línea sin recepción."
                                },
                                "purchase_order_line_id": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "Línea de la orden de compra (lines[].id de la orden); null sin orden."
                                },
                                "unit": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "description": "Unidad base de las cantidades de la línea: pcs, unidades; g, gramos; ml, mililitros."
                                },
                                "quantity": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "description": "Cantidad enviada al proveedor, texto decimal en la unidad base."
                                },
                                "settled_quantity": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "description": "Cuánto de eso reconoció el proveedor."
                                },
                                "unit_cost": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "Precio en la moneda de la devolución por cost_per_quantity; null si no hay precio."
                                },
                                "cost_per_quantity": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "description": "Cantidad en la unidad base a la que corresponde el precio: \"1000\" en un producto por peso es por kilo."
                                },
                                "store_unit_cost_micro": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "El mismo precio en la moneda de la tienda, en millonésimas de la unidad menor; null si no hay precio."
                                },
                                "amount": {
                                    "type": "integer",
                                    "description": "Valor de lo enviado al precio de la línea; la suma de las líneas da subtotal."
                                },
                                "settled_amount": {
                                    "type": "integer",
                                    "description": "Valor de lo que reconoció el proveedor al precio de la línea."
                                },
                                "reason": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "enum": [
                                        "defect",
                                        "wrong_item",
                                        "surplus",
                                        "recall",
                                        "expiry",
                                        "other",
                                        null
                                    ],
                                    "description": "Motivo de la línea con los mismos códigos que el motivo del documento; null si rige el del documento."
                                },
                                "note": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "description": "Nota de la línea; null si no hay."
                                }
                            },
                            "required": [
                                "id",
                                "variant_id",
                                "lot_id",
                                "goods_receipt_line_id",
                                "purchase_order_line_id",
                                "unit",
                                "quantity",
                                "settled_quantity",
                                "unit_cost",
                                "cost_per_quantity",
                                "store_unit_cost_micro",
                                "amount",
                                "settled_amount",
                                "reason",
                                "note"
                            ]
                        },
                        "description": "Líneas de la devolución."
                    },
                    "corrections": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "id": {
                                    "type": "integer",
                                    "description": "ID del registro, único entre los registros de su tipo en la tienda."
                                },
                                "number": {
                                    "type": "string",
                                    "description": "Número de la corrección."
                                },
                                "reason": {
                                    "type": "string",
                                    "description": "Por qué se corrigió; se imprime en el documento y lo ve el proveedor."
                                },
                                "subtotal_before": {
                                    "type": "integer",
                                    "description": "subtotal antes de la corrección."
                                },
                                "subtotal_after": {
                                    "type": "integer",
                                    "description": "subtotal después de la corrección."
                                },
                                "lines": {
                                    "type": "array",
                                    "items": {
                                        "type": "object",
                                        "properties": {
                                            "supplier_return_line_id": {
                                                "type": [
                                                    "integer",
                                                    "null"
                                                ],
                                                "description": "ID de la línea de la devolución (lines[].id); null si la corrección quitó la línea."
                                            },
                                            "variant_id": {
                                                "type": [
                                                    "integer",
                                                    "null"
                                                ],
                                                "description": "Variante del producto de la línea (/v1/variants)."
                                            },
                                            "quantity_before": {
                                                "type": [
                                                    "string",
                                                    "null"
                                                ],
                                                "description": "Cantidad antes de la corrección, en la unidad base."
                                            },
                                            "quantity_after": {
                                                "type": [
                                                    "string",
                                                    "null"
                                                ],
                                                "description": "Cantidad después de la corrección, en la unidad base."
                                            },
                                            "reason_before": {
                                                "type": [
                                                    "string",
                                                    "null"
                                                ],
                                                "enum": [
                                                    "defect",
                                                    "wrong_item",
                                                    "surplus",
                                                    "recall",
                                                    "expiry",
                                                    "other",
                                                    null
                                                ],
                                                "description": "Motivo de la línea antes de la corrección; null si regía el del documento."
                                            },
                                            "reason_after": {
                                                "type": [
                                                    "string",
                                                    "null"
                                                ],
                                                "enum": [
                                                    "defect",
                                                    "wrong_item",
                                                    "surplus",
                                                    "recall",
                                                    "expiry",
                                                    "other",
                                                    null
                                                ],
                                                "description": "Motivo de la línea después de la corrección; null si rige el del documento."
                                            }
                                        },
                                        "required": [
                                            "supplier_return_line_id",
                                            "variant_id",
                                            "quantity_before",
                                            "quantity_after",
                                            "reason_before",
                                            "reason_after"
                                        ]
                                    },
                                    "description": "Líneas corregidas, antes y después."
                                },
                                "created_at": {
                                    "type": "string",
                                    "format": "date-time",
                                    "description": "Cuándo se registró la corrección."
                                }
                            },
                            "required": [
                                "id",
                                "number",
                                "reason",
                                "subtotal_before",
                                "subtotal_after",
                                "lines",
                                "created_at"
                            ]
                        },
                        "description": "Correcciones de la devolución enviada, en orden."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo se creó el registro."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo cambió el registro por última vez."
                    }
                },
                "required": [
                    "id",
                    "number",
                    "status",
                    "reason",
                    "supplier_id",
                    "legal_entity_id",
                    "location_id",
                    "goods_receipt_id",
                    "purchase_order_id",
                    "issued_on",
                    "currency",
                    "exchange_rate",
                    "subtotal",
                    "base_subtotal",
                    "expected_settlement",
                    "settlement",
                    "settled_amount",
                    "base_settled_amount",
                    "shipped_at",
                    "closed_at",
                    "voided_at",
                    "void_reason",
                    "note",
                    "lines",
                    "corrections",
                    "created_at",
                    "updated_at"
                ]
            },
            "SupplierSettlementMode": {
                "type": "string",
                "enum": [
                    "on_receipt",
                    "on_sale"
                ]
            },
            "SupplierStatement": {
                "type": "object",
                "properties": {
                    "supplier_id": {
                        "type": "integer",
                        "description": "ID del proveedor (/v1/suppliers)."
                    },
                    "legal_entity_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Razón social de la tienda para la que se arma la conciliación; null: todas."
                    },
                    "currency": {
                        "type": "string",
                        "enum": [
                            "ARS",
                            "USD",
                            "BRL",
                            "CLP",
                            "COP",
                            "MXN",
                            "PEN",
                            "RUB"
                        ],
                        "description": "Moneda de los importes, código ISO 4217: la moneda de la tienda."
                    },
                    "from": {
                        "type": "string",
                        "description": "Primer día del período, AAAA-MM-DD en la zona horaria de la tienda; sin from en la solicitud, el día de la primera línea de la conciliación."
                    },
                    "to": {
                        "type": "string",
                        "description": "Último día del período, AAAA-MM-DD en la zona horaria de la tienda."
                    },
                    "opening_balance": {
                        "type": "integer",
                        "description": "Deuda al inicio del período: la suma de las líneas anteriores a from."
                    },
                    "closing_balance": {
                        "type": "integer",
                        "description": "Deuda al final del período: opening_balance más las líneas del período. Para hoy coincide con total_due del saldo."
                    },
                    "increase_total": {
                        "type": "integer",
                        "description": "Suma de los aumentos de la deuda en el período."
                    },
                    "decrease_total": {
                        "type": "integer",
                        "description": "Suma de las reducciones de la deuda en el período, en positivo."
                    },
                    "lines": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "date": {
                                    "type": "string",
                                    "description": "Fecha de la línea, AAAA-MM-DD en la zona horaria de la tienda."
                                },
                                "kind": {
                                    "type": "string",
                                    "enum": [
                                        "bill",
                                        "credit_note",
                                        "payment",
                                        "offset",
                                        "out_of_band_payment",
                                        "journal_payment",
                                        "supplier_refund",
                                        "advance",
                                        "fx_difference",
                                        "unbilled_receipt",
                                        "settlement",
                                        "accrual",
                                        "return_claim"
                                    ],
                                    "description": "bill: factura o nota de débito registrada; credit_note: nota de crédito; payment: pago con dinero desde el comprobante; offset: compensación; out_of_band_payment: pago fuera del sistema; journal_payment: pago del libro de dinero; supplier_refund: dinero que devolvió el proveedor; advance: anticipo de una orden de compra; fx_difference: diferencia de cambio; unbilled_receipt: entrega sin comprobante registrado; settlement: liquidación de consignación sin comprobante registrado; accrual: vendido y todavía sin liquidar; return_claim: devolución despachada sin compensar."
                                },
                                "amount": {
                                    "type": "integer",
                                    "description": "Importe de la línea con signo: más, la deuda creció; menos, bajó."
                                },
                                "balance": {
                                    "type": "integer",
                                    "description": "Deuda después de la línea."
                                },
                                "document": {
                                    "type": [
                                        "object",
                                        "null"
                                    ],
                                    "properties": {
                                        "type": {
                                            "type": "string",
                                            "enum": [
                                                "supplier_bill",
                                                "money_transaction",
                                                "purchase_order",
                                                "goods_receipt",
                                                "consignment_settlement",
                                                "supplier_return"
                                            ],
                                            "description": "Tipo de documento: supplier_bill, money_transaction, purchase_order, goods_receipt, consignment_settlement o supplier_return."
                                        },
                                        "id": {
                                            "type": "integer",
                                            "description": "ID del documento."
                                        },
                                        "number": {
                                            "type": [
                                                "string",
                                                "null"
                                            ],
                                            "description": "Número del documento; null si no tiene."
                                        }
                                    },
                                    "required": [
                                        "type",
                                        "id",
                                        "number"
                                    ],
                                    "description": "Documento de la línea; null en lo devengado por consignación."
                                },
                                "supplier_bill_payment_id": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "ID del pago del comprobante (/v1/supplier-bill-payments) en una línea payment; null en las demás."
                                },
                                "money_transaction_id": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "ID del movimiento del libro de dinero (/v1/money-transactions) que pagó el anticipo, en una línea advance; null en las demás."
                                },
                                "settlement_offset_id": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "ID de la compensación (/v1/settlement-offsets) en una línea offset; null en las demás."
                                },
                                "document_amount": {
                                    "type": [
                                        "object",
                                        "null"
                                    ],
                                    "properties": {
                                        "currency": {
                                            "type": "string",
                                            "description": "Moneda del documento, ISO 4217."
                                        },
                                        "amount": {
                                            "type": "integer",
                                            "description": "Importe en unidades menores de la moneda del documento."
                                        }
                                    },
                                    "required": [
                                        "currency",
                                        "amount"
                                    ],
                                    "description": "Importe en la moneda del documento cuando no es la moneda de la tienda; null: moneda de la tienda."
                                }
                            },
                            "required": [
                                "date",
                                "kind",
                                "amount",
                                "balance",
                                "document",
                                "supplier_bill_payment_id",
                                "money_transaction_id",
                                "settlement_offset_id",
                                "document_amount"
                            ]
                        },
                        "description": "Líneas del período por fecha: en un mismo día, primero lo que crea deuda y después lo que la cancela."
                    }
                },
                "required": [
                    "supplier_id",
                    "legal_entity_id",
                    "currency",
                    "from",
                    "to",
                    "opening_balance",
                    "closing_balance",
                    "increase_total",
                    "decrease_total",
                    "lines"
                ]
            },
            "TaxClass": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID del registro, único entre los registros de su tipo en la tienda."
                    },
                    "name": {
                        "type": "object",
                        "additionalProperties": {
                            "type": "string"
                        },
                        "description": "Nombre de la clase de impuesto por idioma, como lo muestra la tienda."
                    },
                    "kind": {
                        "type": "string",
                        "enum": [
                            "taxed",
                            "exempt",
                            "untaxed"
                        ],
                        "description": "Tipo de impuesto: taxed — gravado a la alícuota; exempt — exento por ley; untaxed — no gravado, fuera del alcance del impuesto. Los documentos fiscales distinguen exento de no gravado."
                    },
                    "rate_bps": {
                        "type": "integer",
                        "description": "Alícuota en puntos básicos: 2100 es 21 %. 0 para exempt y untaxed."
                    },
                    "is_default": {
                        "type": "boolean",
                        "description": "Clase predeterminada de la tienda: con ella tributan los productos sin clase propia y el envío. Como máximo una clase de la tienda es la predeterminada."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo se creó el registro."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo cambió el registro por última vez."
                    }
                },
                "required": [
                    "id",
                    "name",
                    "kind",
                    "rate_bps",
                    "is_default",
                    "created_at",
                    "updated_at"
                ]
            },
            "TaxLine": {
                "type": "object",
                "properties": {
                    "regime": {
                        "type": "string",
                        "enum": [
                            "vat",
                            "income",
                            "turnover",
                            "municipal",
                            "internal",
                            "social",
                            "other"
                        ],
                        "description": "Qué impuesto: vat — impuesto al valor agregado (IVA); income — ganancias; turnover — Ingresos Brutos; municipal — tasas municipales; internal — impuestos internos; social — seguridad social; other — otro. El impuesto de una venta es vat: la clase impositiva del producto clasifica el IVA."
                    },
                    "kind": {
                        "type": "string",
                        "enum": [
                            "taxed",
                            "exempt",
                            "untaxed"
                        ],
                        "description": "taxed — a la alícuota; exempt — exento por ley; untaxed — no gravado. Las líneas exempt y untaxed tienen rate_bps 0 y amount 0: el importe está en base."
                    },
                    "rate_bps": {
                        "type": "integer",
                        "description": "Alícuota en puntos básicos: 2100 es 21 %."
                    },
                    "base": {
                        "type": "integer",
                        "description": "Base imponible, sin el impuesto. Los precios incluyen impuestos: base + amount es lo que pagó el cliente por esta parte."
                    },
                    "amount": {
                        "type": "integer",
                        "description": "Importe del impuesto. El impuesto de una venta se calcula por alícuota para todo el pedido, la base redondeada a la unidad más cercana y el impuesto como resto; los ítems y el envío reciben partes de él, así sus líneas suman la línea del pedido."
                    },
                    "jurisdiction": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Provincia o municipio para los impuestos que lo requieren (turnover, municipal); si no, null."
                    }
                },
                "required": [
                    "regime",
                    "kind",
                    "rate_bps",
                    "base",
                    "amount",
                    "jurisdiction"
                ]
            },
            "TaxPeriod": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID del registro, único entre los registros de su tipo en la tienda."
                    },
                    "legal_entity_id": {
                        "type": "integer",
                        "description": "ID de la razón social del período."
                    },
                    "regime": {
                        "type": "string",
                        "enum": [
                            "vat",
                            "income",
                            "turnover",
                            "municipal",
                            "internal",
                            "social",
                            "other"
                        ],
                        "description": "Impuesto del período, el tipo de línea de impuesto: vat — IVA, turnover — Ingresos Brutos y otros."
                    },
                    "period": {
                        "type": "string",
                        "description": "Mes del período, YYYY-MM."
                    },
                    "status": {
                        "type": "string",
                        "enum": [
                            "open",
                            "closed"
                        ],
                        "description": "closed — el período se declaró: los comprobantes con fecha en él no cambian y sus datos son definitivos; open — el período se reabrió. Un mes sin fila está abierto."
                    },
                    "closed_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Cuándo se cerró el período; null si está abierto."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo se creó el registro."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo cambió el registro por última vez."
                    }
                },
                "required": [
                    "id",
                    "legal_entity_id",
                    "regime",
                    "period",
                    "status",
                    "closed_at",
                    "created_at",
                    "updated_at"
                ]
            },
            "TaxWithholding": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID del registro, único entre los registros de su tipo en la tienda."
                    },
                    "legal_entity_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID de la razón social de la tienda (/v1/legal-entities) a la que le retuvieron o que retuvo; null si la razón social se eliminó."
                    },
                    "direction": {
                        "type": "string",
                        "enum": [
                            "suffered",
                            "practiced"
                        ],
                        "description": "suffered: se lo retuvieron a la tienda (proveedor de cobros, banco, cliente agente de retención), es su anticipo de impuesto; practiced: lo retuvo la tienda al pagarle menos a un proveedor, es una obligación de ingresarlo al fisco y no da cómputo."
                    },
                    "kind": {
                        "type": "string",
                        "enum": [
                            "withholding",
                            "perception"
                        ],
                        "description": "withholding: retención, descontada de un pago; perception: percepción, sumada al importe a pagar."
                    },
                    "regime": {
                        "type": "string",
                        "enum": [
                            "vat",
                            "income",
                            "turnover",
                            "municipal",
                            "internal",
                            "social",
                            "other"
                        ],
                        "description": "Qué impuesto se retuvo: vat — IVA, income — Ganancias, turnover — Ingresos Brutos, municipal — tasas municipales y otros."
                    },
                    "jurisdiction": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Provincia o municipio en los impuestos que lo necesitan (turnover, municipal); si no, null."
                    },
                    "credit_regime": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "enum": [
                            "vat",
                            "income",
                            "turnover",
                            "municipal",
                            "internal",
                            "social",
                            "other",
                            null
                        ],
                        "description": "En qué impuesto computa la tienda la retención; null: no hay dónde computarla (saldo a devolver) o la retuvo la tienda (practiced)."
                    },
                    "credit_period": {
                        "type": "string",
                        "description": "Mes de cómputo, YYYY-MM: puede no coincidir con el mes de la retención."
                    },
                    "amount": {
                        "type": "integer",
                        "description": "Importe retenido en unidades mínimas de la moneda de la tienda."
                    },
                    "currency": {
                        "type": "string",
                        "enum": [
                            "ARS",
                            "USD",
                            "BRL",
                            "CLP",
                            "COP",
                            "MXN",
                            "PEN",
                            "RUB"
                        ],
                        "description": "Moneda de los importes, código ISO 4217: la moneda de la tienda."
                    },
                    "base_amount": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Base imponible sobre la que se retuvo, en unidades mínimas de la moneda; null si el respaldo no la tiene."
                    },
                    "rate_bps": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Alícuota en centésimas de punto porcentual: 250 es 2,5 %; null si el respaldo no tiene alícuota."
                    },
                    "rate_source": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "enum": [
                            "padron",
                            "default",
                            "manual",
                            "import",
                            null
                        ],
                        "description": "De dónde sale la alícuota: padron — el padrón del fisco; default — la alícuota por defecto de la configuración de agente; manual — el importe lo cargó una persona del equipo; import — la alícuota del certificado del agente. null si no hay alícuota."
                    },
                    "counterparty_tax_id": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "CUIT u otro número fiscal de la contraparte: el agente que le retuvo a la tienda o el proveedor al que le retuvo la tienda; null si no se conoce."
                    },
                    "counterparty_name": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Nombre de la contraparte al momento de la retención, tal como figura en el certificado; null si no se conoce."
                    },
                    "occurred_on": {
                        "type": "string",
                        "format": "date",
                        "description": "Fecha de la retención, YYYY-MM-DD."
                    },
                    "certificate_number": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Número de certificado: el del certificado del agente en lo que le retuvieron a la tienda, uno de la serie de la tienda en lo que retuvo ella; null si no hay certificado."
                    },
                    "source": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "properties": {
                            "type": {
                                "type": "string",
                                "enum": [
                                    "payment_settlement",
                                    "supplier_bill_payment",
                                    "money_transaction",
                                    "statement_line",
                                    "import_row",
                                    "account_payment_withholding"
                                ],
                                "description": "payment_settlement — liquidación del proveedor de un pago (id es /v1/payments); supplier_bill_payment — pago de una factura de proveedor (id es /v1/supplier-bill-payments); money_transaction — un egreso en el libro de dinero (id es /v1/money-transactions); statement_line — línea de un extracto bancario; import_row — fila de un padrón de agente subido; account_payment_withholding — certificado entregado con un cobro de deuda de cliente: el movimiento de la cuenta corriente lo referencia con tax_withholding_id. Los tres últimos tienen id interno."
                            },
                            "id": {
                                "type": "integer",
                                "description": "ID del registro de origen."
                            }
                        },
                        "required": [
                            "type",
                            "id"
                        ],
                        "description": "El registro que asentó la retención; null: la cargó una persona del equipo."
                    },
                    "note": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Nota de una persona del equipo; null si no hay."
                    },
                    "annulled_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Cuándo la tienda anuló su certificado: el importe ya no es a ingresar y el número sigue ocupado. null en un registro vigente."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo se creó el registro."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo cambió el registro por última vez."
                    }
                },
                "required": [
                    "id",
                    "legal_entity_id",
                    "direction",
                    "kind",
                    "regime",
                    "jurisdiction",
                    "credit_regime",
                    "credit_period",
                    "amount",
                    "currency",
                    "base_amount",
                    "rate_bps",
                    "rate_source",
                    "counterparty_tax_id",
                    "counterparty_name",
                    "occurred_on",
                    "certificate_number",
                    "source",
                    "note",
                    "annulled_at",
                    "created_at",
                    "updated_at"
                ]
            },
            "UpdateCategoryRequest": {
                "type": "object",
                "properties": {
                    "name": {
                        "type": "object",
                        "additionalProperties": {
                            "type": [
                                "string",
                                "null"
                            ],
                            "maxLength": 255
                        },
                        "description": "Nombre por idioma: un objeto con los idiomas completados, por ejemplo {\"es\": \"Café\", \"en\": \"Coffee\"}."
                    },
                    "description": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "additionalProperties": {
                            "type": [
                                "string",
                                "null"
                            ],
                            "maxLength": 50000
                        },
                        "description": "Descripción por idioma en Markdown (GitHub Flavored): un objeto con los idiomas completados."
                    },
                    "slug": {
                        "type": "string",
                        "maxLength": 120,
                        "description": "Dirección de la categoría en la tienda online, única en la tienda."
                    },
                    "parent_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID de la categoría padre; null en una categoría de primer nivel. Las categorías llegan como lista plana; el árbol se arma con este campo."
                    },
                    "position": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 2147483647,
                        "description": "Posición entre las categorías hermanas: la menor va primero."
                    },
                    "is_active": {
                        "type": "boolean",
                        "description": "false oculta la categoría de la tienda online."
                    },
                    "external_id": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "ID externo: el ID del registro en tu sistema; null si la aplicación no lo fijó. Cada aplicación ve solo sus propios ID."
                    }
                }
            },
            "UpdateCustomerAddressRequest": {
                "type": "object",
                "properties": {
                    "label": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 64,
                        "description": "Nombre de la dirección, como Casa o Trabajo; null si no se indicó."
                    },
                    "street": {
                        "type": "string",
                        "maxLength": 255,
                        "description": "Calle."
                    },
                    "house": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 32,
                        "description": "Número de la calle."
                    },
                    "apartment": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 32,
                        "description": "Departamento u oficina."
                    },
                    "floor": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 16,
                        "description": "Piso."
                    },
                    "entrance": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 16,
                        "description": "Entrada."
                    },
                    "district": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 64,
                        "description": "Barrio."
                    },
                    "postal_code": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 16,
                        "description": "Código postal."
                    },
                    "comment": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 500,
                        "description": "Comentario para el cadete, como la forma de entrar; null si no se indicó."
                    },
                    "location": {
                        "type": "object",
                        "properties": {
                            "lat": {
                                "type": "number",
                                "minimum": -90,
                                "maximum": 90,
                                "description": "Latitud en grados."
                            },
                            "lng": {
                                "type": "number",
                                "minimum": -180,
                                "maximum": 180,
                                "description": "Longitud en grados."
                            }
                        },
                        "description": "Ubicación de la dirección en el mapa; null si la dirección vino de otro sistema y aún no se ubicó."
                    },
                    "is_default": {
                        "type": "boolean",
                        "description": "La dirección principal del cliente. Si se elimina la principal, pasa a serlo la más reciente."
                    }
                }
            },
            "UpdateCustomerRequest": {
                "type": "object",
                "properties": {
                    "name": {
                        "type": "string",
                        "pattern": "\\S",
                        "maxLength": 120,
                        "description": "Nombre del cliente; null si se desconoce."
                    },
                    "language": {
                        "$ref": "#/components/schemas/Locale",
                        "description": "Idioma en el que la tienda le escribe al cliente: ru, en o es."
                    },
                    "external_id": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "ID externo del cliente, su ID en tu sistema; null si no está definido. Después de fusionar dos clientes, el ID del fusionado también encuentra al que queda; la respuesta muestra el ID principal."
                    }
                }
            },
            "UpdateDraftOrderRequest": {
                "type": "object",
                "properties": {
                    "customer_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "El cliente del borrador (/v1/customers); null hasta elegirlo."
                    },
                    "delivery_method_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Método de envío (/v1/delivery-methods); null hasta elegirlo."
                    },
                    "address_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Dirección de la libreta del cliente, para un método con envío; null hasta elegirla."
                    },
                    "pickup_location_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Punto de retiro para un método de retiro. Un método con un solo punto lo usa por su cuenta; con varios, el borrador debe nombrar uno."
                    },
                    "delivery_slots": {
                        "type": [
                            "array",
                            "null"
                        ],
                        "items": {
                            "type": "object",
                            "properties": {
                                "from": {
                                    "type": "string",
                                    "description": "Inicio de la franja."
                                },
                                "to": {
                                    "type": "string",
                                    "description": "Fin de la franja."
                                }
                            },
                            "required": [
                                "from",
                                "to"
                            ]
                        },
                        "maxItems": 50,
                        "description": "Franjas de entrega elegidas para un método que trabaja con franjas."
                    },
                    "delivery_cost_override": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "minimum": 0,
                        "maximum": 10000000000,
                        "description": "Precio de envío fijado a mano en lugar del cálculo del método; null — según las reglas del método."
                    },
                    "payment_method": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "enum": [
                            "cash",
                            "mercadopago",
                            "crypto",
                            "bybit",
                            "trc20",
                            "balance",
                            "modo",
                            "payway",
                            "mercadopago_qr",
                            "mercadopago_point",
                            "mercadopago_transfer",
                            "gift_card",
                            "subscription",
                            "deposit",
                            "external",
                            "manual",
                            "offset",
                            "on_account",
                            "exchange_credit",
                            "bonpunto",
                            "service_package",
                            null
                        ],
                        "description": "Medio de pago con el que se confirmará el borrador: de él dependen los descuentos por medio de pago y la compatibilidad con el envío."
                    },
                    "manual_payment_method_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "minimum": 1,
                        "description": "Medio de pago manual de la tienda cuando payment_method es manual; si no, null."
                    },
                    "promocode": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 64,
                        "description": "Cupón aplicado al borrador; null si no hay."
                    },
                    "customer_comment": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 1000,
                        "description": "Comentario del cliente al pedido. Solo con el scope customers:read."
                    },
                    "note": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 1000,
                        "description": "Nota interna de la tienda: pasa al pedido, el cliente no la ve."
                    },
                    "lines": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "id": {
                                    "type": "integer",
                                    "description": "ID de la línea en el borrador."
                                },
                                "variant_id": {
                                    "type": "integer",
                                    "description": "Variante de la línea; null en una línea libre."
                                },
                                "quantity": {
                                    "type": "string",
                                    "maxLength": 32,
                                    "description": "Cantidad como cadena decimal en unit: unidades en un ítem por unidad, la medida en un ítem por peso o volumen (\"480\" gramos)."
                                },
                                "modifiers": {
                                    "type": "array",
                                    "items": {
                                        "type": "object",
                                        "properties": {
                                            "option_id": {
                                                "type": "integer",
                                                "description": "ID de la opción del adicional."
                                            },
                                            "quantity": {
                                                "type": "integer",
                                                "minimum": 1,
                                                "maximum": 99,
                                                "description": "Cuántas veces se agrega el adicional."
                                            }
                                        },
                                        "required": [
                                            "option_id"
                                        ]
                                    },
                                    "maxItems": 50,
                                    "description": "Adicionales de la línea, como los toppings de un plato."
                                }
                            },
                            "required": [
                                "variant_id",
                                "quantity"
                            ]
                        },
                        "maxItems": 200,
                        "uniqueItems": true,
                        "description": "Ítems del borrador. Un borrador abierto se calcula en vivo según el catálogo, los descuentos y el envío; uno cerrado guarda sus ítems sin precios."
                    }
                }
            },
            "UpdateModifierGroupRequest": {
                "type": "object",
                "properties": {
                    "options": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "id": {
                                    "type": "integer",
                                    "description": "ID del registro, único entre los registros de su tipo en la tienda."
                                },
                                "external_id": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "description": "ID externo: el ID del registro en tu sistema; null si la aplicación no lo fijó. Cada aplicación ve solo sus propios ID."
                                },
                                "name": {
                                    "type": "object",
                                    "additionalProperties": {
                                        "type": [
                                            "string",
                                            "null"
                                        ],
                                        "maxLength": 255
                                    },
                                    "description": "Nombre por idioma: un objeto con los idiomas completados, por ejemplo {\"es\": \"Café\", \"en\": \"Coffee\"}."
                                },
                                "price_delta": {
                                    "type": "integer",
                                    "minimum": -100000000,
                                    "maximum": 100000000,
                                    "description": "Recargo sobre el precio del ítem por porción de la opción, entero en unidades menores de la moneda de la tienda; negativo — un descuento. Un producto puede fijar su propio recargo por variante."
                                },
                                "max_quantity": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "minimum": 1,
                                    "maximum": 99,
                                    "description": "Cuántas veces se puede tomar la opción en un ítem; null — sin límite propio, rige solo el max_select del grupo."
                                },
                                "duration_minutes": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "minimum": 5,
                                    "maximum": 120,
                                    "description": "Cuántos minutos suma la opción a un servicio con turno, múltiplo de 5; null — ninguno. No aplica a otros tipos de ítems."
                                },
                                "is_active": {
                                    "type": "boolean",
                                    "description": "false — la opción está apagada y no se ofrece."
                                },
                                "is_default": {
                                    "type": "boolean",
                                    "description": "La opción viene preseleccionada: la tienda y el POS la marcan de entrada, y el servidor completa con ella un grupo obligatorio vacío."
                                },
                                "adds_ingredients": {
                                    "type": [
                                        "boolean",
                                        "null"
                                    ],
                                    "description": "Si esta opción cambia la composición; null — como el grupo (adds_ingredients)."
                                },
                                "recipe_per_variant": {
                                    "type": "boolean",
                                    "description": "El consumo depende del plato: sin composición general, la cantidad la fija la receta de cada variante (option_recipes); sin ella la opción no se ofrece en esa variante."
                                },
                                "nutrition": {
                                    "type": [
                                        "object",
                                        "null"
                                    ],
                                    "properties": {
                                        "kcal": {
                                            "type": "integer",
                                            "minimum": 0,
                                            "maximum": 1000000,
                                            "description": "Energía, kcal."
                                        },
                                        "protein_mg": {
                                            "type": "integer",
                                            "minimum": 0,
                                            "maximum": 100000000,
                                            "description": "Proteínas, mg."
                                        },
                                        "fat_mg": {
                                            "type": "integer",
                                            "minimum": 0,
                                            "maximum": 100000000,
                                            "description": "Grasas, mg."
                                        },
                                        "carbs_mg": {
                                            "type": "integer",
                                            "minimum": 0,
                                            "maximum": 100000000,
                                            "description": "Carbohidratos, mg."
                                        }
                                    },
                                    "description": "Valor nutricional de un uso de la opción declarado por la tienda: los cuatro números o null — entonces lo calcula la composición de la opción."
                                },
                                "recipe": {
                                    "type": "array",
                                    "items": {
                                        "type": "object",
                                        "properties": {
                                            "variant_id": {
                                                "type": "integer",
                                                "description": "ID de la variante del producto."
                                            },
                                            "quantity": {
                                                "type": [
                                                    "string",
                                                    "null"
                                                ],
                                                "maxLength": 32,
                                                "description": "Cantidad del componente por un uso de la opción, como texto decimal en la unidad del componente; null — a gusto: en la composición pero sin consumo."
                                            }
                                        },
                                        "required": [
                                            "variant_id",
                                            "quantity"
                                        ]
                                    },
                                    "maxItems": 100,
                                    "description": "Composición general de la opción — lo que consume en cualquier plato: insumos y preelaborados con su cantidad. Vacía en una opción por plato. Al escribir, la lista completa, una vacía la limpia; sin el campo la composición queda como está."
                                }
                            }
                        },
                        "minItems": 1,
                        "maxItems": 100,
                        "uniqueItems": true,
                        "description": "Opciones en orden de exhibición. Al escribir, el conjunto completo: una fila encuentra su opción por id o external_id, a la encontrada se le escriben los campos enviados, una fila sin opción es nueva y lleva name; una opción que falta en el conjunto se archiva y se quita de los borradores de pedido abiertos."
                    },
                    "name": {
                        "type": "object",
                        "additionalProperties": {
                            "type": [
                                "string",
                                "null"
                            ],
                            "maxLength": 255
                        },
                        "description": "Nombre por idioma: un objeto con los idiomas completados, por ejemplo {\"es\": \"Café\", \"en\": \"Coffee\"}."
                    },
                    "min_select": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 99,
                        "description": "Cuántas opciones debe elegir el cliente: 0 — el grupo es opcional. Un producto puede fijar su propia regla (selection_rule)."
                    },
                    "max_select": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "minimum": 1,
                        "maximum": 99,
                        "description": "Cuántas opciones se pueden elegir en total, con repeticiones; null — sin límite."
                    },
                    "is_active": {
                        "type": "boolean",
                        "description": "false — el grupo está apagado y no se ofrece en los productos."
                    },
                    "adds_ingredients": {
                        "type": "boolean",
                        "description": "Si las opciones del grupo cambian la composición del plato; con true, una opción sin composición propia deja desconocida la composición del ítem (alérgenos)."
                    },
                    "external_id": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "ID externo: el ID del registro en tu sistema; null si la aplicación no lo fijó. Cada aplicación ve solo sus propios ID."
                    }
                }
            },
            "UpdateMoneyTransactionRequest": {
                "type": "object",
                "properties": {
                    "account_id": {
                        "type": "integer",
                        "minimum": 1,
                        "description": "ID de la cuenta de dinero del movimiento."
                    },
                    "direction": {
                        "$ref": "#/components/schemas/MoneyTransactionDirection",
                        "description": "income — ingreso a la cuenta; expense — egreso de la cuenta."
                    },
                    "account_amount": {
                        "type": "string",
                        "maxLength": 37,
                        "description": "Importe en la moneda de la cuenta, como cadena decimal."
                    },
                    "amount": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "minimum": 0,
                        "maximum": 100000000000000,
                        "description": "Importe del asiento en unidades mínimas de la moneda de la tienda, siempre positivo: el signo lo da direction. En una cuenta en otra moneda, convertido al tipo de cambio de la foto."
                    },
                    "occurred_on": {
                        "type": "string",
                        "format": "date",
                        "description": "Fecha contable, YYYY-MM-DD en la zona horaria de la tienda."
                    },
                    "occurred_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Momento del movimiento."
                    },
                    "category_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID de la categoría; null en una transferencia entre cuentas o un movimiento sin categoría."
                    },
                    "supplier_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID del proveedor contraparte; null si no hay."
                    },
                    "description": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 1000,
                        "description": "Comentario del movimiento como lo escribió una persona o un documento; null si no hay."
                    }
                }
            },
            "UpdateMoneyTransferRequest": {
                "type": "object",
                "properties": {
                    "from_account_id": {
                        "type": "integer",
                        "minimum": 1,
                        "description": "ID de la cuenta de dinero de la que salió el dinero."
                    },
                    "to_account_id": {
                        "type": "integer",
                        "minimum": 1,
                        "description": "ID de la cuenta de dinero a la que entró el dinero."
                    },
                    "from_amount": {
                        "type": "string",
                        "maxLength": 37,
                        "description": "Importe que salió de from_account_id en su moneda, como cadena decimal."
                    },
                    "to_amount": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 37,
                        "description": "Importe que entró en to_account_id en su moneda, como cadena decimal. En la misma moneda es igual a from_amount: la diferencia es la comisión fee."
                    },
                    "fee": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 37,
                        "description": "Comisión de la transferencia en la moneda de la cuenta de origen, como cadena decimal: un egreso en la categoría de sistema bank_fees; null si no hay comisión."
                    },
                    "occurred_on": {
                        "type": "string",
                        "format": "date",
                        "description": "Fecha contable de la transferencia, YYYY-MM-DD en la zona horaria de la tienda."
                    },
                    "occurred_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Momento de la transferencia."
                    },
                    "description": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 1000,
                        "description": "Descripción de la transferencia; null si no se cargó."
                    }
                }
            },
            "UpdatePriceListRequest": {
                "type": "object",
                "properties": {
                    "name": {
                        "type": "string",
                        "maxLength": 120,
                        "description": "Nuevo nombre de una lista mayorista, hasta 120 caracteres. El nombre de una lista de local lo da el local: el campo se rechaza."
                    },
                    "adjustment_bp": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 50000,
                        "description": "Nuevo ajuste en puntos básicos (1 % = 100): sobre el precio base en una lista de local, de −9000 a 50000; sobre el costo en una mayorista, desde 0. Sin el campo, no cambia."
                    },
                    "rounding": {
                        "type": "object",
                        "properties": {
                            "mode": {
                                "$ref": "#/components/schemas/DiscountRoundingMode",
                                "description": "Sentido del redondeo: nearest — al más cercano, up — hacia arriba, down — hacia abajo."
                            },
                            "precision": {
                                "type": "integer",
                                "description": "Posición del redondeo en dígitos de unidades mayores: 2 — a centésimos, 0 — a enteros, -2 — a centenas. Valen las posiciones de la configuración de precios de la tienda y la de la unidad menor de la moneda, es decir, sin redondeo."
                            }
                        },
                        "description": "Nuevo redondeo del precio según la regla de la lista, con mode y precision juntos; sin el campo, no cambia. Los precios fijos y los de productos por peso o volumen no se redondean."
                    }
                }
            },
            "UpdateProductMediaRequest": {
                "type": "object",
                "properties": {
                    "position": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 10000,
                        "description": "Lugar en la galería, desde cero."
                    },
                    "is_primary": {
                        "type": "boolean",
                        "description": "La foto principal: la tienda online la muestra primero."
                    }
                }
            },
            "UpdateProductRequest": {
                "type": "object",
                "properties": {
                    "name": {
                        "type": "object",
                        "additionalProperties": {
                            "type": [
                                "string",
                                "null"
                            ],
                            "maxLength": 255
                        },
                        "description": "Nombre por idioma: un objeto con los idiomas completados, por ejemplo {\"es\": \"Café\", \"en\": \"Coffee\"}."
                    },
                    "short_description": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "additionalProperties": {
                            "type": [
                                "string",
                                "null"
                            ],
                            "maxLength": 500
                        },
                        "description": "Descripción breve por idioma, texto plano para las listas de productos."
                    },
                    "description": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "additionalProperties": {
                            "type": [
                                "string",
                                "null"
                            ],
                            "maxLength": 50000
                        },
                        "description": "Descripción por idioma en Markdown (GitHub Flavored): un objeto con los idiomas completados."
                    },
                    "slug": {
                        "type": "string",
                        "maxLength": 160,
                        "description": "Dirección del producto en la tienda online, única en la tienda."
                    },
                    "brand_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID de la marca del producto; null si no está definida."
                    },
                    "tax_class_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID de la clase de impuesto del producto (/v1/tax-classes); null — la clase predeterminada de la tienda. Una venta conserva la alícuota de su ítem: un cambio de clase afecta solo a las ventas futuras."
                    },
                    "category_ids": {
                        "type": "array",
                        "items": {
                            "type": "integer"
                        },
                        "description": "ID de las categorías del producto, en orden ascendente."
                    },
                    "primary_category_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "La categoría principal entre category_ids; null si no se eligió una principal."
                    },
                    "is_active": {
                        "type": "boolean",
                        "description": "false retira el producto de la venta y lo oculta de la tienda online."
                    },
                    "published_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Cuándo aparece el producto en la tienda online; null — de inmediato."
                    },
                    "unpublished_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Cuándo sale el producto de la tienda online; null — se queda."
                    },
                    "sale_schedule": {
                        "type": [
                            "array",
                            "null"
                        ],
                        "items": {
                            "type": "object",
                            "properties": {
                                "days": {
                                    "type": "array",
                                    "items": {
                                        "type": "integer",
                                        "minimum": 1,
                                        "maximum": 7
                                    },
                                    "minItems": 1,
                                    "maxItems": 7,
                                    "description": "Días de la franja, ISO: 1 es lunes, 7 es domingo."
                                },
                                "from": {
                                    "type": "string",
                                    "pattern": "^(?:[01]\\d|2[0-3]):[0-5]\\d$|^24:00$",
                                    "description": "Inicio de la franja, «HH:MM» según el reloj del comercio."
                                },
                                "to": {
                                    "type": "string",
                                    "pattern": "^(?:[01]\\d|2[0-3]):[0-5]\\d$|^24:00$",
                                    "description": "Fin de la franja, «HH:MM», sin incluir ese momento; «24:00» — hasta el final del día. Un fin anterior al inicio hace que la franja pase la medianoche; pertenece a su día de inicio."
                                }
                            },
                            "required": [
                                "days",
                                "from",
                                "to"
                            ]
                        },
                        "maxItems": 14,
                        "description": "Cuándo se puede pedir el producto — franjas de la semana en la zona horaria del comercio; null — siempre. Fuera de la franja el producto sigue visible y se puede agregar al carrito, y el checkout compara el horario con el momento de entrega del pedido."
                    },
                    "external_id": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "ID externo: el ID del registro en tu sistema; null si la aplicación no lo fijó. Cada aplicación ve solo sus propios ID."
                    },
                    "variants": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "external_id": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "description": "ID externo de la variante, su ID en tu sistema: la clave con la que se encuentra la línea."
                                },
                                "sku": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "maxLength": 64,
                                    "description": "Código de artículo (SKU); null si no está definido."
                                },
                                "name": {
                                    "type": [
                                        "object",
                                        "null"
                                    ],
                                    "additionalProperties": {
                                        "type": [
                                            "string",
                                            "null"
                                        ],
                                        "maxLength": 255
                                    },
                                    "description": "Nombre de la variante por idioma, por ejemplo {\"es\": \"Grande\"}."
                                },
                                "price": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 10000000000,
                                    "description": "Precio por price_per_quantity unidades, entero en unidades mínimas de currency."
                                },
                                "track_inventory": {
                                    "type": "boolean",
                                    "description": "La tienda lleva el stock de la variante; false — se vende sin contar stock."
                                },
                                "is_active": {
                                    "type": "boolean",
                                    "description": "false retira la variante de la venta."
                                },
                                "position": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 2147483647,
                                    "description": "Posición entre las variantes del producto: la menor va primero."
                                },
                                "list_price": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 10000000000,
                                    "description": "Precio tal como lo fijó el dueño, en unidades mínimas de list_price_currency; null — el precio se fijó en la moneda de la tienda (price). En esa variante price lo calcula el sistema con la cotización de la lista y no se acepta en la entrada."
                                },
                                "list_price_currency": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "enum": [
                                        "ARS",
                                        "USD",
                                        "BRL",
                                        "CLP",
                                        "COP",
                                        "MXN",
                                        "PEN",
                                        "RUB",
                                        null
                                    ],
                                    "description": "Moneda del precio fijado (lista de la tienda en otra moneda); null — precio en la moneda de la tienda currency. En la entrada: la moneda de la lista de la tienda o currency."
                                },
                                "compare_at_price": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "maximum": 10000000000,
                                    "description": "Precio antes del descuento, se muestra tachado; null si no hay descuento."
                                },
                                "weight_grams": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "minimum": 0,
                                    "maximum": 2147483647,
                                    "description": "Peso para el envío en gramos; null si no está definido."
                                },
                                "length_mm": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "minimum": 0,
                                    "maximum": 2147483647,
                                    "description": "Largo del paquete en milímetros; null si no está definido."
                                },
                                "width_mm": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "minimum": 0,
                                    "maximum": 2147483647,
                                    "description": "Ancho del paquete en milímetros; null si no está definido."
                                },
                                "height_mm": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "minimum": 0,
                                    "maximum": 2147483647,
                                    "description": "Alto del paquete en milímetros; null si no está definido."
                                },
                                "sale_starts_at": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "format": "date-time",
                                    "description": "Cuándo empieza la oferta: compare_at_price se muestra desde ese momento; null — sin inicio."
                                },
                                "sale_ends_at": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "format": "date-time",
                                    "description": "Cuándo termina la oferta; null — sin fin."
                                },
                                "sold_by": {
                                    "type": "string",
                                    "enum": [
                                        "each",
                                        "weight",
                                        "volume"
                                    ],
                                    "description": "Cómo se vende la variante: each — por unidad; weight — por peso; volume — por volumen."
                                },
                                "price_per_quantity": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "maxLength": 32,
                                    "description": "Por cuántas unidades es el precio, como cadena decimal: una unidad, o 1000 para el precio por kilo de una variante por peso. null si una variante por peso o volumen no lo tiene definido."
                                },
                                "measure_step": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "maxLength": 32,
                                    "description": "Paso de la cantidad en un ítem de una variante por peso o volumen, en su unidad; null si no está definido."
                                },
                                "min_measure_qty": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "maxLength": 32,
                                    "description": "Cantidad mínima en un ítem de una variante por peso o volumen; null si no está definida."
                                },
                                "max_measure_qty": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "maxLength": 32,
                                    "description": "Cantidad máxima en un ítem de una variante por peso o volumen; null si no está definida."
                                },
                                "net_content": {
                                    "type": "object",
                                    "properties": {
                                        "quantity": {
                                            "type": "string",
                                            "maxLength": 32,
                                            "description": "Medida como cadena decimal en unit: \"500\", \"0.5\"."
                                        },
                                        "unit": {
                                            "type": "string",
                                            "enum": [
                                                "g",
                                                "ml"
                                            ],
                                            "description": "Unidad de la medida: g — gramos; ml — mililitros."
                                        }
                                    },
                                    "description": "Contenido neto de una unidad: paquete de 500 g, botella de 1000 ml. Un pack de varias unidades de otra variante lo toma de ella, una unidad envasada, de su propia medida; solo se puede escribir en una variante común por unidad. null en variantes por peso o volumen y en unidades sin contenido neto."
                                },
                                "barcodes": {
                                    "type": [
                                        "array",
                                        "null"
                                    ],
                                    "items": {
                                        "type": "object",
                                        "properties": {
                                            "type": {
                                                "type": "string",
                                                "enum": [
                                                    "ean13",
                                                    "ean8",
                                                    "upca",
                                                    "upce",
                                                    "code128",
                                                    "code39",
                                                    "gtin",
                                                    "itf",
                                                    "qr",
                                                    "datamatrix",
                                                    "other"
                                                ],
                                                "description": "Simbología: ean13, ean8, upca, upce, code128, code39, gtin, itf, qr, datamatrix u other."
                                            },
                                            "value": {
                                                "type": "string",
                                                "description": "El código de barras."
                                            },
                                            "is_primary": {
                                                "type": [
                                                    "boolean",
                                                    "null"
                                                ],
                                                "description": "El código de barras principal de la variante: lo imprimen las etiquetas y los tickets."
                                            }
                                        },
                                        "required": [
                                            "type",
                                            "value"
                                        ]
                                    },
                                    "maxItems": 20,
                                    "description": "Códigos de barras de la variante."
                                },
                                "option_values": {
                                    "type": "array",
                                    "items": {
                                        "type": "object",
                                        "properties": {
                                            "option_id": {
                                                "type": "integer",
                                                "description": "ID de la opción en options del producto."
                                            },
                                            "value_id": {
                                                "type": "integer",
                                                "description": "ID del valor en values de esa opción."
                                            }
                                        },
                                        "required": [
                                            "option_id",
                                            "value_id"
                                        ]
                                    },
                                    "maxItems": 10,
                                    "description": "Valores de opción de la variante: un valor de cada opción del producto."
                                }
                            }
                        },
                        "minItems": 1,
                        "maxItems": 200,
                        "description": "Líneas de variantes escritas junto con la ficha. Una línea se encuentra por su external_id: la variante del producto con ese ID se cambia con los campos enviados; si no hay, se crea una; las variantes no mencionadas quedan como están. Crear un producto exige al menos una línea con precio."
                    }
                }
            },
            "UpdateRecommendationRuleRequest": {
                "type": "object",
                "properties": {
                    "source_type": {
                        "$ref": "#/components/schemas/RecommendationRuleSource",
                        "description": "A qué se aplica la regla: category — productos de la categoría y sus subcategorías; collection — productos de la colección."
                    },
                    "source_id": {
                        "type": "integer",
                        "minimum": 1,
                        "description": "ID de la categoría o colección a cuyos productos se aplica la regla. Cada origen tiene una sola regla."
                    },
                    "target_collection_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID de la colección cuyos productos ofrece la regla después de los suyos; null — sin colección."
                    },
                    "product_ids": {
                        "type": "array",
                        "items": {
                            "type": "integer"
                        },
                        "maxItems": 20,
                        "uniqueItems": true,
                        "description": "ID de los productos que ofrece la regla, en el orden del estante; como máximo 20."
                    },
                    "exclusive": {
                        "type": "boolean",
                        "description": "true — «solo esta regla»: las reglas de abajo y la selección automática no completan el estante; sin productos ni colección oculta el estante."
                    },
                    "is_active": {
                        "type": "boolean",
                        "description": "false apaga la regla: se guarda pero no se aplica."
                    },
                    "position": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 2147483647,
                        "description": "Prioridad: la regla con el valor menor se aplica antes."
                    }
                }
            },
            "UpdateSupplierBillRequest": {
                "type": "object",
                "properties": {
                    "kind": {
                        "type": "string",
                        "enum": [
                            "invoice",
                            "debit_note",
                            "credit_note"
                        ],
                        "description": "invoice: factura; debit_note: nota de débito, aumenta la deuda; credit_note: nota de crédito, reduce la deuda (devolución, descuento, corrección). Los importes del comprobante son siempre positivos y el signo lo da kind."
                    },
                    "fiscal": {
                        "type": "boolean",
                        "description": "false: deuda por una entrega sin factura, sin datos de ARCA y fuera del libro de compras; true: factura o nota."
                    },
                    "legal_entity_id": {
                        "type": "integer",
                        "description": "ID de la razón social compradora de la tienda (/v1/legal-entities)."
                    },
                    "supplier_id": {
                        "type": "integer",
                        "description": "ID del proveedor (/v1/suppliers)."
                    },
                    "related_bill_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID del comprobante que corrige la nota; null en una factura y en una nota sin referencia."
                    },
                    "number": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 20,
                        "description": "Número del comprobante como lo cargó la tienda; null en una deuda sin factura."
                    },
                    "issued_on": {
                        "type": "string",
                        "format": "date",
                        "description": "Fecha del comprobante, YYYY-MM-DD en la zona horaria de la tienda."
                    },
                    "tax_period": {
                        "type": "string",
                        "description": "Período fiscal en el que el comprobante va al libro de compras, YYYY-MM."
                    },
                    "due_on": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date",
                        "description": "Vencimiento, YYYY-MM-DD en la zona horaria de la tienda; null: sin vencimiento."
                    },
                    "currency": {
                        "type": "string",
                        "enum": [
                            "ARS",
                            "USD",
                            "BRL",
                            "CLP",
                            "COP",
                            "MXN",
                            "PEN",
                            "RUB"
                        ],
                        "description": "Moneda del comprobante, ISO 4217: en ella están todos los importes salvo base_total."
                    },
                    "exchange_rate": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "pattern": "^\\d{1,14}(\\.\\d{1,10})?$",
                        "maxLength": 1000000000000,
                        "description": "Cotización de la moneda del comprobante a la de la tienda como cadena decimal; null en un comprobante en la moneda de la tienda."
                    },
                    "net_taxed": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 10000000000,
                        "description": "Neto gravado de IVA."
                    },
                    "net_exempt": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 10000000000,
                        "description": "Importe exento de IVA."
                    },
                    "net_untaxed": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 10000000000,
                        "description": "Importe no gravado de IVA."
                    },
                    "tax_total": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 10000000000,
                        "description": "IVA del comprobante."
                    },
                    "total": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 10000000000,
                        "description": "Total del comprobante: neto, impuestos y percepciones."
                    },
                    "note": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 2000,
                        "description": "Nota del personal; null si no hay."
                    },
                    "lines": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "description": {
                                    "type": "string",
                                    "maxLength": 300,
                                    "description": "Descripción de la línea como en el comprobante."
                                },
                                "variant_id": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "description": "ID de la variante del producto (/v1/variants); null en una línea que no es de un producto."
                                },
                                "quantity": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "pattern": "^\\d{1,14}(\\.\\d{1,6})?$",
                                    "minLength": 0,
                                    "maxLength": 1000000000000,
                                    "description": "Cantidad como cadena decimal; null si no figura."
                                },
                                "unit_amount": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "minimum": 0,
                                    "maximum": 10000000000,
                                    "description": "Precio unitario sin impuestos; null si no figura."
                                },
                                "net_amount": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 10000000000,
                                    "description": "Importe de la línea sin impuestos."
                                },
                                "tax_kind": {
                                    "type": "string",
                                    "enum": [
                                        "taxed",
                                        "exempt",
                                        "untaxed"
                                    ],
                                    "description": "taxed: gravado a una alícuota; exempt: exento; untaxed: no gravado."
                                },
                                "rate_bps": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 10000,
                                    "description": "Alícuota de IVA en puntos básicos: 2100 es 21 %."
                                },
                                "tax_amount": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 10000000000,
                                    "description": "IVA de la línea."
                                }
                            },
                            "required": [
                                "description",
                                "net_amount",
                                "tax_kind"
                            ]
                        },
                        "maxItems": 500,
                        "description": "Líneas del comprobante en orden; un comprobante cargado por totales no tiene líneas."
                    },
                    "additional_taxes": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "kind": {
                                    "type": "string",
                                    "enum": [
                                        "perception",
                                        "withholding",
                                        "internal",
                                        "other"
                                    ],
                                    "description": "perception: percepción, aumenta el importe a pagar y la tienda la computa; withholding: retención, la tienda la retiene al pagar y la ingresa al fisco, el importe transferido baja; internal: impuestos internos; other: otros tributos."
                                },
                                "regime": {
                                    "type": "string",
                                    "enum": [
                                        "vat",
                                        "income",
                                        "turnover",
                                        "municipal",
                                        "internal",
                                        "social",
                                        "other"
                                    ],
                                    "description": "Qué impuesto: vat: IVA; income: Ganancias; turnover: Ingresos Brutos; municipal: tasas municipales, y otros."
                                },
                                "jurisdiction": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "pattern": "^[A-Z]{2}-[A-Z0-9]{1,5}$",
                                    "maxLength": 8,
                                    "description": "Jurisdicción del impuesto, por ejemplo la provincia de Ingresos Brutos; null si el impuesto no la necesita."
                                },
                                "amount": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 10000000000,
                                    "description": "Importe del impuesto."
                                },
                                "certificate_number": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "maxLength": 64,
                                    "description": "Número del certificado de retención o percepción; null si no hay."
                                }
                            },
                            "required": [
                                "kind",
                                "regime",
                                "amount"
                            ]
                        },
                        "maxItems": 50,
                        "description": "Impuestos además del IVA: percepciones, retenciones, internos y otros. El comprobante solo trae su importe, sin base ni alícuota."
                    },
                    "goods_receipt_ids": {
                        "type": "array",
                        "items": {
                            "type": "integer"
                        },
                        "maxItems": 100,
                        "description": "Recepciones que cubre el documento (/v1/goods-receipts): entregas conciliadas con la factura o la entrega de una deuda por entrega."
                    },
                    "purchase_order_ids": {
                        "type": "array",
                        "items": {
                            "type": "integer"
                        },
                        "maxItems": 100,
                        "description": "Órdenes de compra a las que corresponde el documento (/v1/purchase-orders)."
                    },
                    "supplier_return_ids": {
                        "type": "array",
                        "items": {
                            "type": "integer"
                        },
                        "maxItems": 100,
                        "description": "Devoluciones a proveedores por las que se emitió la nota de crédito (/v1/supplier-returns)."
                    },
                    "ar": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "properties": {
                            "document_type_code": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "maxLength": 3,
                                "description": "Código de tipo de comprobante de ARCA: 001: factura A; 006: factura B; 011: factura C; null si no figura."
                            },
                            "point_of_sale": {
                                "type": [
                                    "integer",
                                    "null"
                                ],
                                "minimum": 0,
                                "maximum": 99999,
                                "description": "Punto de venta del proveedor; null si no figura."
                            },
                            "authorization_kind": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "enum": [
                                    "CAE",
                                    "CAEA",
                                    "CAI",
                                    null
                                ],
                                "description": "CAE: comprobante electrónico; CAEA: código otorgado por período; CAI: talonario impreso; null: sin autorización (por ejemplo, un comprobante del exterior)."
                            },
                            "authorization_code": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "maxLength": 14,
                                "description": "Código de autorización; null si no figura."
                            },
                            "authorization_expires_on": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "format": "date",
                                "description": "Vencimiento del código de autorización, YYYY-MM-DD; null si no figura."
                            },
                            "credit_fiscal_amount": {
                                "type": [
                                    "integer",
                                    "null"
                                ],
                                "minimum": 0,
                                "maximum": 10000000000,
                                "description": "Parte computable del IVA con prorrateo del crédito fiscal; null: se computa todo el impuesto."
                            },
                            "import": {
                                "type": [
                                    "object",
                                    "null"
                                ],
                                "properties": {
                                    "kind": {
                                        "type": "string",
                                        "enum": [
                                            "goods",
                                            "services"
                                        ],
                                        "description": "goods: importación de bienes con despacho; services: servicios de un prestador del exterior."
                                    },
                                    "customs_declaration": {
                                        "type": [
                                            "string",
                                            "null"
                                        ],
                                        "maxLength": 16,
                                        "description": "Número de despacho de la importación de bienes; null si no se indicó."
                                    },
                                    "document_kind": {
                                        "type": [
                                            "string",
                                            "null"
                                        ],
                                        "enum": [
                                            "invoice",
                                            "contract",
                                            "other",
                                            null
                                        ],
                                        "description": "Documento del prestador: invoice (factura), contract (contrato) u other (otro, con descripción); null si no se indicó."
                                    },
                                    "document_description": {
                                        "type": [
                                            "string",
                                            "null"
                                        ],
                                        "maxLength": 20,
                                        "description": "Descripción del documento de tipo other; null en los demás."
                                    },
                                    "provider_tax_id": {
                                        "type": [
                                            "string",
                                            "null"
                                        ],
                                        "maxLength": 20,
                                        "description": "Identificación fiscal del prestador en su país; null si no se indicó."
                                    },
                                    "tax_paid_on": {
                                        "type": [
                                            "string",
                                            "null"
                                        ],
                                        "format": "date",
                                        "description": "Fecha de pago del IVA por la importación de servicios, YYYY-MM-DD; null si no se indicó."
                                    },
                                    "tax_paid_amount": {
                                        "type": [
                                            "integer",
                                            "null"
                                        ],
                                        "minimum": 0,
                                        "maximum": 10000000000,
                                        "description": "IVA pagado por la importación de servicios en la moneda del documento; null si no se indicó."
                                    },
                                    "payment_reference": {
                                        "type": [
                                            "string",
                                            "null"
                                        ],
                                        "maxLength": 20,
                                        "description": "Identificación del pago del impuesto; null si no se indicó."
                                    },
                                    "payment_entity_tax_id": {
                                        "type": [
                                            "string",
                                            "null"
                                        ],
                                        "maxLength": 11,
                                        "description": "CUIT del banco por el que se ingresó el impuesto; null si no se indicó."
                                    }
                                },
                                "description": "Importación de bienes o servicios, con su propio diseño del libro de importaciones de ARCA; null en un documento local."
                            }
                        },
                        "description": "Datos de ARCA de la factura o nota; null en una deuda por entrega sin factura."
                    }
                }
            },
            "UpdateSupplierRequest": {
                "type": "object",
                "properties": {
                    "name": {
                        "type": "string",
                        "maxLength": 200,
                        "description": "Nombre del proveedor como lo ve la tienda."
                    },
                    "legal_name": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 200,
                        "description": "Razón social; null si no está cargada."
                    },
                    "tax_id": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 32,
                        "description": "Número fiscal como lo cargó la tienda (CUIT en Argentina); null si no está cargado."
                    },
                    "tax_id_country": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "País del número fiscal, ISO 3166-1 alfa-2; null si el número no está cargado."
                    },
                    "is_active": {
                        "type": "boolean",
                        "description": "false: el proveedor está desactivado; no se le hacen pedidos nuevos y los documentos quedan."
                    },
                    "payment_term_days": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "minimum": 0,
                        "maximum": 365,
                        "description": "Plazo de pago en días: con él se calcula el vencimiento due_on del comprobante. null: sin plazo."
                    },
                    "prices_include_tax": {
                        "type": [
                            "boolean",
                            "null"
                        ],
                        "description": "true: el proveedor cotiza con impuestos; false: sin impuestos; null: según la regla de la tienda."
                    },
                    "settlement_mode": {
                        "$ref": "#/components/schemas/SupplierSettlementMode",
                        "description": "on_receipt: compra común, la deuda nace con la recepción; on_sale: consignación, la tienda paga lo vendido según la liquidación de consignación."
                    },
                    "consignment_loss_policy": {
                        "$ref": "#/components/schemas/ConsignmentLossPolicy",
                        "description": "Quién paga la mercadería en consignación vencida o faltante: return_to_supplier: a cargo del proveedor, con devolución de la mercadería; our_cost: pérdida de la tienda."
                    },
                    "lead_time_days": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "minimum": 1,
                        "maximum": 365,
                        "description": "Plazo de entrega en días desde el pedido; null si no está cargado."
                    },
                    "min_order_amount": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Monto mínimo de pedido en unidades mínimas de currency; null: sin mínimo."
                    },
                    "currency": {
                        "type": "string",
                        "description": "Moneda de compra con el proveedor, ISO 4217: en ella están min_order_amount y los precios de sus pedidos."
                    },
                    "external_id": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "ID externo: el ID del registro en tu sistema; null si la aplicación no lo fijó. Cada aplicación ve solo sus propios ID."
                    }
                }
            },
            "UpdateVariantRequest": {
                "type": "object",
                "properties": {
                    "external_id": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "ID externo: el ID del registro en tu sistema; null si la aplicación no lo fijó. Cada aplicación ve solo sus propios ID."
                    },
                    "sku": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 64,
                        "description": "Código de artículo (SKU); null si no está definido."
                    },
                    "name": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "additionalProperties": {
                            "type": [
                                "string",
                                "null"
                            ],
                            "maxLength": 255
                        },
                        "description": "Nombre de la variante por idioma, por ejemplo {\"es\": \"Grande\"}."
                    },
                    "price": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 10000000000,
                        "description": "Precio por price_per_quantity unidades, entero en unidades mínimas de currency."
                    },
                    "track_inventory": {
                        "type": "boolean",
                        "description": "La tienda lleva el stock de la variante; false — se vende sin contar stock."
                    },
                    "is_active": {
                        "type": "boolean",
                        "description": "false retira la variante de la venta."
                    },
                    "position": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 2147483647,
                        "description": "Posición entre las variantes del producto: la menor va primero."
                    },
                    "list_price": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 10000000000,
                        "description": "Precio tal como lo fijó el dueño, en unidades mínimas de list_price_currency; null — el precio se fijó en la moneda de la tienda (price). En esa variante price lo calcula el sistema con la cotización de la lista y no se acepta en la entrada."
                    },
                    "list_price_currency": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "enum": [
                            "ARS",
                            "USD",
                            "BRL",
                            "CLP",
                            "COP",
                            "MXN",
                            "PEN",
                            "RUB",
                            null
                        ],
                        "description": "Moneda del precio fijado (lista de la tienda en otra moneda); null — precio en la moneda de la tienda currency. En la entrada: la moneda de la lista de la tienda o currency."
                    },
                    "compare_at_price": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "maximum": 10000000000,
                        "description": "Precio antes del descuento, se muestra tachado; null si no hay descuento."
                    },
                    "weight_grams": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "minimum": 0,
                        "maximum": 2147483647,
                        "description": "Peso para el envío en gramos; null si no está definido."
                    },
                    "length_mm": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "minimum": 0,
                        "maximum": 2147483647,
                        "description": "Largo del paquete en milímetros; null si no está definido."
                    },
                    "width_mm": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "minimum": 0,
                        "maximum": 2147483647,
                        "description": "Ancho del paquete en milímetros; null si no está definido."
                    },
                    "height_mm": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "minimum": 0,
                        "maximum": 2147483647,
                        "description": "Alto del paquete en milímetros; null si no está definido."
                    },
                    "sale_starts_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Cuándo empieza la oferta: compare_at_price se muestra desde ese momento; null — sin inicio."
                    },
                    "sale_ends_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Cuándo termina la oferta; null — sin fin."
                    },
                    "sold_by": {
                        "type": "string",
                        "enum": [
                            "each",
                            "weight",
                            "volume"
                        ],
                        "description": "Cómo se vende la variante: each — por unidad; weight — por peso; volume — por volumen."
                    },
                    "price_per_quantity": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 32,
                        "description": "Por cuántas unidades es el precio, como cadena decimal: una unidad, o 1000 para el precio por kilo de una variante por peso. null si una variante por peso o volumen no lo tiene definido."
                    },
                    "measure_step": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 32,
                        "description": "Paso de la cantidad en un ítem de una variante por peso o volumen, en su unidad; null si no está definido."
                    },
                    "min_measure_qty": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 32,
                        "description": "Cantidad mínima en un ítem de una variante por peso o volumen; null si no está definida."
                    },
                    "max_measure_qty": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 32,
                        "description": "Cantidad máxima en un ítem de una variante por peso o volumen; null si no está definida."
                    },
                    "net_content": {
                        "type": "object",
                        "properties": {
                            "quantity": {
                                "type": "string",
                                "maxLength": 32,
                                "description": "Medida como cadena decimal en unit: \"500\", \"0.5\"."
                            },
                            "unit": {
                                "type": "string",
                                "enum": [
                                    "g",
                                    "ml"
                                ],
                                "description": "Unidad de la medida: g — gramos; ml — mililitros."
                            }
                        },
                        "description": "Contenido neto de una unidad: paquete de 500 g, botella de 1000 ml. Un pack de varias unidades de otra variante lo toma de ella, una unidad envasada, de su propia medida; solo se puede escribir en una variante común por unidad. null en variantes por peso o volumen y en unidades sin contenido neto."
                    },
                    "barcodes": {
                        "type": [
                            "array",
                            "null"
                        ],
                        "items": {
                            "type": "object",
                            "properties": {
                                "type": {
                                    "type": "string",
                                    "enum": [
                                        "ean13",
                                        "ean8",
                                        "upca",
                                        "upce",
                                        "code128",
                                        "code39",
                                        "gtin",
                                        "itf",
                                        "qr",
                                        "datamatrix",
                                        "other"
                                    ],
                                    "description": "Simbología: ean13, ean8, upca, upce, code128, code39, gtin, itf, qr, datamatrix u other."
                                },
                                "value": {
                                    "type": "string",
                                    "description": "El código de barras."
                                },
                                "is_primary": {
                                    "type": [
                                        "boolean",
                                        "null"
                                    ],
                                    "description": "El código de barras principal de la variante: lo imprimen las etiquetas y los tickets."
                                }
                            },
                            "required": [
                                "type",
                                "value"
                            ]
                        },
                        "maxItems": 20,
                        "description": "Códigos de barras de la variante."
                    },
                    "option_values": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "option_id": {
                                    "type": "integer",
                                    "description": "ID de la opción en options del producto."
                                },
                                "value_id": {
                                    "type": "integer",
                                    "description": "ID del valor en values de esa opción."
                                }
                            },
                            "required": [
                                "option_id",
                                "value_id"
                            ]
                        },
                        "maxItems": 10,
                        "description": "Valores de opción de la variante: un valor de cada opción del producto."
                    },
                    "stock_source_variant_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "En un pack de varias unidades de otra variante: esa variante. El pack se vende de su stock y no tiene niveles de stock propios. null en una variante común."
                    },
                    "stock_source_quantity": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 32,
                        "description": "Cuánto de la variante base consume una unidad del pack, como cadena decimal en la unidad de la variante base; null en una variante común."
                    }
                }
            },
            "UpdateWebhookEndpointRequest": {
                "type": "object",
                "properties": {
                    "url": {
                        "type": "string",
                        "maxLength": 2048,
                        "description": "Dirección HTTPS a la que se envían las entregas."
                    },
                    "description": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 255,
                        "description": "Descripción del endpoint; null si no se indicó."
                    },
                    "enabled_events": {
                        "type": "array",
                        "items": {
                            "type": "string",
                            "enum": [
                                "order.created",
                                "order.updated",
                                "order.status_changed",
                                "order.paid",
                                "order.cancelled",
                                "payment.created",
                                "payment.succeeded",
                                "payment.status_changed",
                                "payment.updated",
                                "refund.created",
                                "refund.completed",
                                "refund.status_changed",
                                "refund.updated",
                                "fiscal_document.created",
                                "fiscal_document.updated",
                                "fiscal_document.issued",
                                "fiscal_document.failed",
                                "fiscal_document.annulled",
                                "tax_period.status_changed",
                                "money_transaction.created",
                                "money_transaction.updated",
                                "money_transaction.deleted",
                                "pos_shift.opened",
                                "pos_shift.closed",
                                "pos_shift.updated",
                                "pos_cash_movement.created",
                                "gift_card.created",
                                "gift_card.updated",
                                "gift_card_transaction.created",
                                "customer_account.created",
                                "customer_account.updated",
                                "customer_account_entry.created",
                                "customer_account_entry.updated",
                                "supplier.created",
                                "supplier.updated",
                                "supplier.deleted",
                                "supplier_bill.created",
                                "supplier_bill.updated",
                                "supplier_bill.posted",
                                "supplier_bill.voided",
                                "supplier_bill.deleted",
                                "supplier_bill_payment.created",
                                "supplier_bill_payment.updated",
                                "supplier_bill_payment.deleted",
                                "settlement_agreement.created",
                                "settlement_agreement.updated",
                                "settlement_agreement.deleted",
                                "settlement_offset.created",
                                "settlement_offset.updated",
                                "settlement_offset.voided",
                                "purchase_order.created",
                                "purchase_order.updated",
                                "purchase_order.status_changed",
                                "purchase_order.deleted",
                                "goods_receipt.created",
                                "goods_receipt.updated",
                                "goods_receipt.voided",
                                "supplier_return.created",
                                "supplier_return.updated",
                                "supplier_return.status_changed",
                                "supplier_return.deleted",
                                "consignment_settlement.created",
                                "consignment_settlement.updated",
                                "consignment_settlement.posted",
                                "consignment_settlement.voided",
                                "tax_withholding.created",
                                "tax_withholding.updated",
                                "tax_withholding.annulled",
                                "tax_withholding.deleted",
                                "product.created",
                                "product.updated",
                                "product.deleted",
                                "inventory_level.updated",
                                "stock_movement.created",
                                "stock_movement.updated",
                                "lot.created",
                                "lot.updated",
                                "lot.deleted",
                                "location_transfer.created",
                                "location_transfer.updated",
                                "stocktake.created",
                                "stocktake.status_changed",
                                "stocktake.updated",
                                "customer.created",
                                "customer.updated",
                                "customer.deleted",
                                "customer_group.created",
                                "customer_group.updated",
                                "customer_group.deleted",
                                "price_list.created",
                                "price_list.updated",
                                "price_list.deleted",
                                "bulk_operation.finished"
                            ]
                        },
                        "minItems": 1,
                        "maxItems": 93,
                        "uniqueItems": true,
                        "description": "Tipos de evento a los que está suscripto el endpoint, como order.created; son los tipos de GET /v1/events. Un tipo cuyo scope de lectura perdió la aplicación no se entrega."
                    },
                    "status": {
                        "type": "string",
                        "enum": [
                            "enabled",
                            "disabled"
                        ],
                        "description": "enabled — las entregas salen; disabled — lo desactivó la aplicación o la plataforma (disabled_reason)."
                    }
                }
            },
            "Upload": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID del registro, único entre los registros de su tipo en la tienda."
                    },
                    "file_name": {
                        "type": "string",
                        "description": "Nombre del archivo dado al iniciar la carga."
                    },
                    "size": {
                        "type": "integer",
                        "description": "Tamaño del archivo completo en bytes."
                    },
                    "received": {
                        "type": "integer",
                        "description": "Bytes recibidos: el desplazamiento de la siguiente parte."
                    },
                    "complete": {
                        "type": "boolean",
                        "description": "El archivo está armado: una operación masiva puede tomarlo por id. Después de eso la carga deja de existir."
                    },
                    "chunk_bytes": {
                        "type": "integer",
                        "description": "Tamaño máximo de una parte en bytes."
                    },
                    "expires_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Después de este momento una carga no usada se elimina."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo se creó el registro."
                    }
                },
                "required": [
                    "id",
                    "file_name",
                    "size",
                    "received",
                    "complete",
                    "chunk_bytes",
                    "expires_at",
                    "created_at"
                ]
            },
            "UpsertCategoryRequest": {
                "type": "object",
                "properties": {
                    "name": {
                        "type": "object",
                        "additionalProperties": {
                            "type": [
                                "string",
                                "null"
                            ],
                            "maxLength": 255
                        },
                        "description": "Nombre por idioma: un objeto con los idiomas completados, por ejemplo {\"es\": \"Café\", \"en\": \"Coffee\"}."
                    },
                    "description": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "additionalProperties": {
                            "type": [
                                "string",
                                "null"
                            ],
                            "maxLength": 50000
                        },
                        "description": "Descripción por idioma en Markdown (GitHub Flavored): un objeto con los idiomas completados."
                    },
                    "slug": {
                        "type": "string",
                        "maxLength": 120,
                        "description": "Dirección de la categoría en la tienda online, única en la tienda."
                    },
                    "parent_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID de la categoría padre; null en una categoría de primer nivel. Las categorías llegan como lista plana; el árbol se arma con este campo."
                    },
                    "position": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 2147483647,
                        "description": "Posición entre las categorías hermanas: la menor va primero."
                    },
                    "is_active": {
                        "type": "boolean",
                        "description": "false oculta la categoría de la tienda online."
                    }
                }
            },
            "UpsertCustomerRequest": {
                "type": "object",
                "properties": {
                    "name": {
                        "type": "string",
                        "pattern": "\\S",
                        "maxLength": 120,
                        "description": "Nombre del cliente; null si se desconoce."
                    },
                    "language": {
                        "$ref": "#/components/schemas/Locale",
                        "description": "Idioma en el que la tienda le escribe al cliente: ru, en o es."
                    },
                    "phone": {
                        "type": "string",
                        "maxLength": 32,
                        "description": "Teléfono principal del cliente en formato E.164, por ejemplo +5491123456789; null si se desconoce."
                    },
                    "email": {
                        "type": "string",
                        "maxLength": 254,
                        "description": "Email del cliente; null si se desconoce."
                    }
                }
            },
            "UpsertModifierGroupRequest": {
                "type": "object",
                "properties": {
                    "options": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "id": {
                                    "type": "integer",
                                    "description": "ID del registro, único entre los registros de su tipo en la tienda."
                                },
                                "external_id": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "description": "ID externo: el ID del registro en tu sistema; null si la aplicación no lo fijó. Cada aplicación ve solo sus propios ID."
                                },
                                "name": {
                                    "type": "object",
                                    "additionalProperties": {
                                        "type": [
                                            "string",
                                            "null"
                                        ],
                                        "maxLength": 255
                                    },
                                    "description": "Nombre por idioma: un objeto con los idiomas completados, por ejemplo {\"es\": \"Café\", \"en\": \"Coffee\"}."
                                },
                                "price_delta": {
                                    "type": "integer",
                                    "minimum": -100000000,
                                    "maximum": 100000000,
                                    "description": "Recargo sobre el precio del ítem por porción de la opción, entero en unidades menores de la moneda de la tienda; negativo — un descuento. Un producto puede fijar su propio recargo por variante."
                                },
                                "max_quantity": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "minimum": 1,
                                    "maximum": 99,
                                    "description": "Cuántas veces se puede tomar la opción en un ítem; null — sin límite propio, rige solo el max_select del grupo."
                                },
                                "duration_minutes": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "minimum": 5,
                                    "maximum": 120,
                                    "description": "Cuántos minutos suma la opción a un servicio con turno, múltiplo de 5; null — ninguno. No aplica a otros tipos de ítems."
                                },
                                "is_active": {
                                    "type": "boolean",
                                    "description": "false — la opción está apagada y no se ofrece."
                                },
                                "is_default": {
                                    "type": "boolean",
                                    "description": "La opción viene preseleccionada: la tienda y el POS la marcan de entrada, y el servidor completa con ella un grupo obligatorio vacío."
                                },
                                "adds_ingredients": {
                                    "type": [
                                        "boolean",
                                        "null"
                                    ],
                                    "description": "Si esta opción cambia la composición; null — como el grupo (adds_ingredients)."
                                },
                                "recipe_per_variant": {
                                    "type": "boolean",
                                    "description": "El consumo depende del plato: sin composición general, la cantidad la fija la receta de cada variante (option_recipes); sin ella la opción no se ofrece en esa variante."
                                },
                                "nutrition": {
                                    "type": [
                                        "object",
                                        "null"
                                    ],
                                    "properties": {
                                        "kcal": {
                                            "type": "integer",
                                            "minimum": 0,
                                            "maximum": 1000000,
                                            "description": "Energía, kcal."
                                        },
                                        "protein_mg": {
                                            "type": "integer",
                                            "minimum": 0,
                                            "maximum": 100000000,
                                            "description": "Proteínas, mg."
                                        },
                                        "fat_mg": {
                                            "type": "integer",
                                            "minimum": 0,
                                            "maximum": 100000000,
                                            "description": "Grasas, mg."
                                        },
                                        "carbs_mg": {
                                            "type": "integer",
                                            "minimum": 0,
                                            "maximum": 100000000,
                                            "description": "Carbohidratos, mg."
                                        }
                                    },
                                    "description": "Valor nutricional de un uso de la opción declarado por la tienda: los cuatro números o null — entonces lo calcula la composición de la opción."
                                },
                                "recipe": {
                                    "type": "array",
                                    "items": {
                                        "type": "object",
                                        "properties": {
                                            "variant_id": {
                                                "type": "integer",
                                                "description": "ID de la variante del producto."
                                            },
                                            "quantity": {
                                                "type": [
                                                    "string",
                                                    "null"
                                                ],
                                                "maxLength": 32,
                                                "description": "Cantidad del componente por un uso de la opción, como texto decimal en la unidad del componente; null — a gusto: en la composición pero sin consumo."
                                            }
                                        },
                                        "required": [
                                            "variant_id",
                                            "quantity"
                                        ]
                                    },
                                    "maxItems": 100,
                                    "description": "Composición general de la opción — lo que consume en cualquier plato: insumos y preelaborados con su cantidad. Vacía en una opción por plato. Al escribir, la lista completa, una vacía la limpia; sin el campo la composición queda como está."
                                }
                            }
                        },
                        "minItems": 1,
                        "maxItems": 100,
                        "uniqueItems": true,
                        "description": "Opciones en orden de exhibición. Al escribir, el conjunto completo: una fila encuentra su opción por id o external_id, a la encontrada se le escriben los campos enviados, una fila sin opción es nueva y lleva name; una opción que falta en el conjunto se archiva y se quita de los borradores de pedido abiertos."
                    },
                    "name": {
                        "type": "object",
                        "additionalProperties": {
                            "type": [
                                "string",
                                "null"
                            ],
                            "maxLength": 255
                        },
                        "description": "Nombre por idioma: un objeto con los idiomas completados, por ejemplo {\"es\": \"Café\", \"en\": \"Coffee\"}."
                    },
                    "min_select": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 99,
                        "description": "Cuántas opciones debe elegir el cliente: 0 — el grupo es opcional. Un producto puede fijar su propia regla (selection_rule)."
                    },
                    "max_select": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "minimum": 1,
                        "maximum": 99,
                        "description": "Cuántas opciones se pueden elegir en total, con repeticiones; null — sin límite."
                    },
                    "is_active": {
                        "type": "boolean",
                        "description": "false — el grupo está apagado y no se ofrece en los productos."
                    },
                    "adds_ingredients": {
                        "type": "boolean",
                        "description": "Si las opciones del grupo cambian la composición del plato; con true, una opción sin composición propia deja desconocida la composición del ítem (alérgenos)."
                    }
                }
            },
            "UpsertProductRequest": {
                "type": "object",
                "properties": {
                    "name": {
                        "type": "object",
                        "additionalProperties": {
                            "type": [
                                "string",
                                "null"
                            ],
                            "maxLength": 255
                        },
                        "description": "Nombre por idioma: un objeto con los idiomas completados, por ejemplo {\"es\": \"Café\", \"en\": \"Coffee\"}."
                    },
                    "short_description": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "additionalProperties": {
                            "type": [
                                "string",
                                "null"
                            ],
                            "maxLength": 500
                        },
                        "description": "Descripción breve por idioma, texto plano para las listas de productos."
                    },
                    "description": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "additionalProperties": {
                            "type": [
                                "string",
                                "null"
                            ],
                            "maxLength": 50000
                        },
                        "description": "Descripción por idioma en Markdown (GitHub Flavored): un objeto con los idiomas completados."
                    },
                    "slug": {
                        "type": "string",
                        "maxLength": 160,
                        "description": "Dirección del producto en la tienda online, única en la tienda."
                    },
                    "brand_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID de la marca del producto; null si no está definida."
                    },
                    "tax_class_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID de la clase de impuesto del producto (/v1/tax-classes); null — la clase predeterminada de la tienda. Una venta conserva la alícuota de su ítem: un cambio de clase afecta solo a las ventas futuras."
                    },
                    "category_ids": {
                        "type": "array",
                        "items": {
                            "type": "integer"
                        },
                        "description": "ID de las categorías del producto, en orden ascendente."
                    },
                    "primary_category_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "La categoría principal entre category_ids; null si no se eligió una principal."
                    },
                    "is_active": {
                        "type": "boolean",
                        "description": "false retira el producto de la venta y lo oculta de la tienda online."
                    },
                    "published_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Cuándo aparece el producto en la tienda online; null — de inmediato."
                    },
                    "unpublished_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Cuándo sale el producto de la tienda online; null — se queda."
                    },
                    "sale_schedule": {
                        "type": [
                            "array",
                            "null"
                        ],
                        "items": {
                            "type": "object",
                            "properties": {
                                "days": {
                                    "type": "array",
                                    "items": {
                                        "type": "integer",
                                        "minimum": 1,
                                        "maximum": 7
                                    },
                                    "minItems": 1,
                                    "maxItems": 7,
                                    "description": "Días de la franja, ISO: 1 es lunes, 7 es domingo."
                                },
                                "from": {
                                    "type": "string",
                                    "pattern": "^(?:[01]\\d|2[0-3]):[0-5]\\d$|^24:00$",
                                    "description": "Inicio de la franja, «HH:MM» según el reloj del comercio."
                                },
                                "to": {
                                    "type": "string",
                                    "pattern": "^(?:[01]\\d|2[0-3]):[0-5]\\d$|^24:00$",
                                    "description": "Fin de la franja, «HH:MM», sin incluir ese momento; «24:00» — hasta el final del día. Un fin anterior al inicio hace que la franja pase la medianoche; pertenece a su día de inicio."
                                }
                            },
                            "required": [
                                "days",
                                "from",
                                "to"
                            ]
                        },
                        "maxItems": 14,
                        "description": "Cuándo se puede pedir el producto — franjas de la semana en la zona horaria del comercio; null — siempre. Fuera de la franja el producto sigue visible y se puede agregar al carrito, y el checkout compara el horario con el momento de entrega del pedido."
                    },
                    "type": {
                        "type": "string",
                        "enum": [
                            "goods",
                            "dish",
                            "ingredient",
                            "prep"
                        ],
                        "description": "Tipo de producto: goods — mercadería para la venta; dish — plato que se prepara al pedido; ingredient — materia prima para recetas; prep — semielaborado de preparación propia; manufactured — producción propia de la tienda; meal_program — plan de comidas por suscripción; bundle — combo de otros productos; gift_card — tarjeta de regalo; service — servicio con turno."
                    },
                    "stock_unit": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "properties": {
                            "unit": {
                                "type": "string",
                                "enum": [
                                    "g",
                                    "ml",
                                    "pcs"
                                ],
                                "description": "Unidad base: g — gramos, ml — mililitros, pcs — unidades. Las cantidades de las variantes del producto son textos decimales en esta unidad."
                            },
                            "purchase_unit": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "maxLength": 16,
                                "description": "Nombre del envase de compra, por ejemplo kg o caja; null — el ítem se compra en su unidad base."
                            },
                            "purchase_quantity": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "maxLength": 32,
                                "description": "Cuántas unidades base hay en un envase de compra, como texto decimal: por ejemplo, 1000 para un kilo de un ítem que se lleva en gramos."
                            }
                        },
                        "description": "Unidad de stock de un ítem con stock por medida (insumo, preelaborado, producto fabricado): en ella se llevan el stock, las recetas y el rendimiento. null en mercadería y platos: su unidad es el eje de venta de la variante."
                    },
                    "variants": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "external_id": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "description": "ID externo de la variante, su ID en tu sistema: la clave con la que se encuentra la línea."
                                },
                                "sku": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "maxLength": 64,
                                    "description": "Código de artículo (SKU); null si no está definido."
                                },
                                "name": {
                                    "type": [
                                        "object",
                                        "null"
                                    ],
                                    "additionalProperties": {
                                        "type": [
                                            "string",
                                            "null"
                                        ],
                                        "maxLength": 255
                                    },
                                    "description": "Nombre de la variante por idioma, por ejemplo {\"es\": \"Grande\"}."
                                },
                                "price": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 10000000000,
                                    "description": "Precio por price_per_quantity unidades, entero en unidades mínimas de currency."
                                },
                                "track_inventory": {
                                    "type": "boolean",
                                    "description": "La tienda lleva el stock de la variante; false — se vende sin contar stock."
                                },
                                "is_active": {
                                    "type": "boolean",
                                    "description": "false retira la variante de la venta."
                                },
                                "position": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 2147483647,
                                    "description": "Posición entre las variantes del producto: la menor va primero."
                                },
                                "list_price": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 10000000000,
                                    "description": "Precio tal como lo fijó el dueño, en unidades mínimas de list_price_currency; null — el precio se fijó en la moneda de la tienda (price). En esa variante price lo calcula el sistema con la cotización de la lista y no se acepta en la entrada."
                                },
                                "list_price_currency": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "enum": [
                                        "ARS",
                                        "USD",
                                        "BRL",
                                        "CLP",
                                        "COP",
                                        "MXN",
                                        "PEN",
                                        "RUB",
                                        null
                                    ],
                                    "description": "Moneda del precio fijado (lista de la tienda en otra moneda); null — precio en la moneda de la tienda currency. En la entrada: la moneda de la lista de la tienda o currency."
                                },
                                "compare_at_price": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "maximum": 10000000000,
                                    "description": "Precio antes del descuento, se muestra tachado; null si no hay descuento."
                                },
                                "weight_grams": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "minimum": 0,
                                    "maximum": 2147483647,
                                    "description": "Peso para el envío en gramos; null si no está definido."
                                },
                                "length_mm": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "minimum": 0,
                                    "maximum": 2147483647,
                                    "description": "Largo del paquete en milímetros; null si no está definido."
                                },
                                "width_mm": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "minimum": 0,
                                    "maximum": 2147483647,
                                    "description": "Ancho del paquete en milímetros; null si no está definido."
                                },
                                "height_mm": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ],
                                    "minimum": 0,
                                    "maximum": 2147483647,
                                    "description": "Alto del paquete en milímetros; null si no está definido."
                                },
                                "sale_starts_at": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "format": "date-time",
                                    "description": "Cuándo empieza la oferta: compare_at_price se muestra desde ese momento; null — sin inicio."
                                },
                                "sale_ends_at": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "format": "date-time",
                                    "description": "Cuándo termina la oferta; null — sin fin."
                                },
                                "sold_by": {
                                    "type": "string",
                                    "enum": [
                                        "each",
                                        "weight",
                                        "volume"
                                    ],
                                    "description": "Cómo se vende la variante: each — por unidad; weight — por peso; volume — por volumen."
                                },
                                "price_per_quantity": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "maxLength": 32,
                                    "description": "Por cuántas unidades es el precio, como cadena decimal: una unidad, o 1000 para el precio por kilo de una variante por peso. null si una variante por peso o volumen no lo tiene definido."
                                },
                                "measure_step": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "maxLength": 32,
                                    "description": "Paso de la cantidad en un ítem de una variante por peso o volumen, en su unidad; null si no está definido."
                                },
                                "min_measure_qty": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "maxLength": 32,
                                    "description": "Cantidad mínima en un ítem de una variante por peso o volumen; null si no está definida."
                                },
                                "max_measure_qty": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "maxLength": 32,
                                    "description": "Cantidad máxima en un ítem de una variante por peso o volumen; null si no está definida."
                                },
                                "net_content": {
                                    "type": "object",
                                    "properties": {
                                        "quantity": {
                                            "type": "string",
                                            "maxLength": 32,
                                            "description": "Medida como cadena decimal en unit: \"500\", \"0.5\"."
                                        },
                                        "unit": {
                                            "type": "string",
                                            "enum": [
                                                "g",
                                                "ml"
                                            ],
                                            "description": "Unidad de la medida: g — gramos; ml — mililitros."
                                        }
                                    },
                                    "description": "Contenido neto de una unidad: paquete de 500 g, botella de 1000 ml. Un pack de varias unidades de otra variante lo toma de ella, una unidad envasada, de su propia medida; solo se puede escribir en una variante común por unidad. null en variantes por peso o volumen y en unidades sin contenido neto."
                                },
                                "barcodes": {
                                    "type": [
                                        "array",
                                        "null"
                                    ],
                                    "items": {
                                        "type": "object",
                                        "properties": {
                                            "type": {
                                                "type": "string",
                                                "enum": [
                                                    "ean13",
                                                    "ean8",
                                                    "upca",
                                                    "upce",
                                                    "code128",
                                                    "code39",
                                                    "gtin",
                                                    "itf",
                                                    "qr",
                                                    "datamatrix",
                                                    "other"
                                                ],
                                                "description": "Simbología: ean13, ean8, upca, upce, code128, code39, gtin, itf, qr, datamatrix u other."
                                            },
                                            "value": {
                                                "type": "string",
                                                "description": "El código de barras."
                                            },
                                            "is_primary": {
                                                "type": [
                                                    "boolean",
                                                    "null"
                                                ],
                                                "description": "El código de barras principal de la variante: lo imprimen las etiquetas y los tickets."
                                            }
                                        },
                                        "required": [
                                            "type",
                                            "value"
                                        ]
                                    },
                                    "maxItems": 20,
                                    "description": "Códigos de barras de la variante."
                                },
                                "option_values": {
                                    "type": "array",
                                    "items": {
                                        "type": "object",
                                        "properties": {
                                            "option_id": {
                                                "type": "integer",
                                                "description": "ID de la opción en options del producto."
                                            },
                                            "value_id": {
                                                "type": "integer",
                                                "description": "ID del valor en values de esa opción."
                                            }
                                        },
                                        "required": [
                                            "option_id",
                                            "value_id"
                                        ]
                                    },
                                    "maxItems": 10,
                                    "description": "Valores de opción de la variante: un valor de cada opción del producto."
                                }
                            }
                        },
                        "minItems": 1,
                        "maxItems": 200,
                        "description": "Líneas de variantes escritas junto con la ficha. Una línea se encuentra por su external_id: la variante del producto con ese ID se cambia con los campos enviados; si no hay, se crea una; las variantes no mencionadas quedan como están. Crear un producto exige al menos una línea con precio."
                    }
                }
            },
            "UpsertVariantRequest": {
                "type": "object",
                "properties": {
                    "product_id": {
                        "type": "integer",
                        "description": "ID del producto."
                    },
                    "sku": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 64,
                        "description": "Código de artículo (SKU); null si no está definido."
                    },
                    "name": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "additionalProperties": {
                            "type": [
                                "string",
                                "null"
                            ],
                            "maxLength": 255
                        },
                        "description": "Nombre de la variante por idioma, por ejemplo {\"es\": \"Grande\"}."
                    },
                    "price": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 10000000000,
                        "description": "Precio por price_per_quantity unidades, entero en unidades mínimas de currency."
                    },
                    "track_inventory": {
                        "type": "boolean",
                        "description": "La tienda lleva el stock de la variante; false — se vende sin contar stock."
                    },
                    "is_active": {
                        "type": "boolean",
                        "description": "false retira la variante de la venta."
                    },
                    "position": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 2147483647,
                        "description": "Posición entre las variantes del producto: la menor va primero."
                    },
                    "list_price": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 10000000000,
                        "description": "Precio tal como lo fijó el dueño, en unidades mínimas de list_price_currency; null — el precio se fijó en la moneda de la tienda (price). En esa variante price lo calcula el sistema con la cotización de la lista y no se acepta en la entrada."
                    },
                    "list_price_currency": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "enum": [
                            "ARS",
                            "USD",
                            "BRL",
                            "CLP",
                            "COP",
                            "MXN",
                            "PEN",
                            "RUB",
                            null
                        ],
                        "description": "Moneda del precio fijado (lista de la tienda en otra moneda); null — precio en la moneda de la tienda currency. En la entrada: la moneda de la lista de la tienda o currency."
                    },
                    "compare_at_price": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "maximum": 10000000000,
                        "description": "Precio antes del descuento, se muestra tachado; null si no hay descuento."
                    },
                    "weight_grams": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "minimum": 0,
                        "maximum": 2147483647,
                        "description": "Peso para el envío en gramos; null si no está definido."
                    },
                    "length_mm": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "minimum": 0,
                        "maximum": 2147483647,
                        "description": "Largo del paquete en milímetros; null si no está definido."
                    },
                    "width_mm": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "minimum": 0,
                        "maximum": 2147483647,
                        "description": "Ancho del paquete en milímetros; null si no está definido."
                    },
                    "height_mm": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "minimum": 0,
                        "maximum": 2147483647,
                        "description": "Alto del paquete en milímetros; null si no está definido."
                    },
                    "sale_starts_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Cuándo empieza la oferta: compare_at_price se muestra desde ese momento; null — sin inicio."
                    },
                    "sale_ends_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Cuándo termina la oferta; null — sin fin."
                    },
                    "sold_by": {
                        "type": "string",
                        "enum": [
                            "each",
                            "weight",
                            "volume"
                        ],
                        "description": "Cómo se vende la variante: each — por unidad; weight — por peso; volume — por volumen."
                    },
                    "price_per_quantity": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 32,
                        "description": "Por cuántas unidades es el precio, como cadena decimal: una unidad, o 1000 para el precio por kilo de una variante por peso. null si una variante por peso o volumen no lo tiene definido."
                    },
                    "measure_step": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 32,
                        "description": "Paso de la cantidad en un ítem de una variante por peso o volumen, en su unidad; null si no está definido."
                    },
                    "min_measure_qty": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 32,
                        "description": "Cantidad mínima en un ítem de una variante por peso o volumen; null si no está definida."
                    },
                    "max_measure_qty": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 32,
                        "description": "Cantidad máxima en un ítem de una variante por peso o volumen; null si no está definida."
                    },
                    "net_content": {
                        "type": "object",
                        "properties": {
                            "quantity": {
                                "type": "string",
                                "maxLength": 32,
                                "description": "Medida como cadena decimal en unit: \"500\", \"0.5\"."
                            },
                            "unit": {
                                "type": "string",
                                "enum": [
                                    "g",
                                    "ml"
                                ],
                                "description": "Unidad de la medida: g — gramos; ml — mililitros."
                            }
                        },
                        "description": "Contenido neto de una unidad: paquete de 500 g, botella de 1000 ml. Un pack de varias unidades de otra variante lo toma de ella, una unidad envasada, de su propia medida; solo se puede escribir en una variante común por unidad. null en variantes por peso o volumen y en unidades sin contenido neto."
                    },
                    "barcodes": {
                        "type": [
                            "array",
                            "null"
                        ],
                        "items": {
                            "type": "object",
                            "properties": {
                                "type": {
                                    "type": "string",
                                    "enum": [
                                        "ean13",
                                        "ean8",
                                        "upca",
                                        "upce",
                                        "code128",
                                        "code39",
                                        "gtin",
                                        "itf",
                                        "qr",
                                        "datamatrix",
                                        "other"
                                    ],
                                    "description": "Simbología: ean13, ean8, upca, upce, code128, code39, gtin, itf, qr, datamatrix u other."
                                },
                                "value": {
                                    "type": "string",
                                    "description": "El código de barras."
                                },
                                "is_primary": {
                                    "type": [
                                        "boolean",
                                        "null"
                                    ],
                                    "description": "El código de barras principal de la variante: lo imprimen las etiquetas y los tickets."
                                }
                            },
                            "required": [
                                "type",
                                "value"
                            ]
                        },
                        "maxItems": 20,
                        "description": "Códigos de barras de la variante."
                    },
                    "option_values": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "option_id": {
                                    "type": "integer",
                                    "description": "ID de la opción en options del producto."
                                },
                                "value_id": {
                                    "type": "integer",
                                    "description": "ID del valor en values de esa opción."
                                }
                            },
                            "required": [
                                "option_id",
                                "value_id"
                            ]
                        },
                        "maxItems": 10,
                        "description": "Valores de opción de la variante: un valor de cada opción del producto."
                    },
                    "stock_source_variant_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "En un pack de varias unidades de otra variante: esa variante. El pack se vende de su stock y no tiene niveles de stock propios. null en una variante común."
                    },
                    "stock_source_quantity": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 32,
                        "description": "Cuánto de la variante base consume una unidad del pack, como cadena decimal en la unidad de la variante base; null en una variante común."
                    },
                    "sibling_name": {
                        "type": "object",
                        "additionalProperties": {
                            "type": [
                                "string",
                                "null"
                            ],
                            "maxLength": 255
                        },
                        "description": "Nombre por idioma de la única variante del producto, que esta solicitud convierte en una de varias: la única variante no tiene nombre propio, una de varias debe tenerlo."
                    }
                }
            },
            "ValidationProblem": {
                "type": "object",
                "properties": {
                    "type": {
                        "type": "string",
                        "description": "Tipo técnico del problema: un código estable para decidir qué hacer, como insufficient_scope. Cada tipo tiene una página en el catálogo de errores."
                    },
                    "title": {
                        "type": "string",
                        "description": "Resumen breve del problema en el idioma de la solicitud."
                    },
                    "status": {
                        "type": "integer",
                        "description": "Estado HTTP de la respuesta."
                    },
                    "detail": {
                        "type": "string",
                        "description": "Explicación de este caso en el idioma de la solicitud."
                    },
                    "errors": {
                        "type": "object",
                        "additionalProperties": {
                            "type": "array",
                            "items": {
                                "type": "string"
                            }
                        },
                        "description": "Campos con errores: nombre del campo (los anidados con puntos, como variants.0.price) → mensajes."
                    }
                },
                "required": [
                    "type",
                    "title",
                    "status",
                    "errors"
                ]
            },
            "Variant": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID del registro, único entre los registros de su tipo en la tienda."
                    },
                    "external_id": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "ID externo: el ID del registro en tu sistema; null si la aplicación no lo fijó. Cada aplicación ve solo sus propios ID."
                    },
                    "version": {
                        "type": "integer",
                        "description": "Versión de la ficha del producto: las variantes cambian bajo la versión común de la ficha, así que cambiar cualquier variante o la ficha la mueve."
                    },
                    "product_id": {
                        "type": "integer",
                        "description": "ID del producto."
                    },
                    "sku": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Código de artículo (SKU); null si no está definido."
                    },
                    "name": {
                        "type": "object",
                        "additionalProperties": {
                            "type": "string"
                        },
                        "description": "Nombre de la variante por idioma, por ejemplo {\"es\": \"Grande\"}."
                    },
                    "position": {
                        "type": "integer",
                        "description": "Posición entre las variantes del producto: la menor va primero."
                    },
                    "is_active": {
                        "type": "boolean",
                        "description": "false retira la variante de la venta."
                    },
                    "barcodes": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "value": {
                                    "type": "string",
                                    "description": "El código de barras."
                                },
                                "type": {
                                    "type": "string",
                                    "description": "Simbología: ean13, ean8, upca, upce, code128, code39, gtin, itf, qr, datamatrix u other."
                                },
                                "is_primary": {
                                    "type": "boolean",
                                    "description": "El código de barras principal de la variante: lo imprimen las etiquetas y los tickets."
                                }
                            },
                            "required": [
                                "value",
                                "type",
                                "is_primary"
                            ]
                        },
                        "description": "Códigos de barras de la variante."
                    },
                    "option_values": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "option_id": {
                                    "type": "integer",
                                    "description": "ID de la opción en options del producto."
                                },
                                "value_id": {
                                    "type": "integer",
                                    "description": "ID del valor en values de esa opción."
                                }
                            },
                            "required": [
                                "option_id",
                                "value_id"
                            ]
                        },
                        "description": "Valores de opción de la variante: un valor de cada opción del producto."
                    },
                    "sold_by": {
                        "type": "string",
                        "enum": [
                            "each",
                            "weight",
                            "volume"
                        ],
                        "description": "Cómo se vende la variante: each — por unidad; weight — por peso; volume — por volumen."
                    },
                    "unit": {
                        "type": "string",
                        "enum": [
                            "pcs",
                            "g",
                            "ml"
                        ],
                        "description": "Unidad de todas las cantidades de la variante: pcs — unidades; g — gramos; ml — mililitros."
                    },
                    "quantity_decimals": {
                        "type": "integer",
                        "enum": [
                            0,
                            3
                        ],
                        "description": "Decimales de las cantidades de la variante: 0 por unidad, 3 por peso y por volumen."
                    },
                    "price": {
                        "type": "integer",
                        "description": "Precio por price_per_quantity unidades, entero en unidades mínimas de currency."
                    },
                    "compare_at_price": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Precio antes del descuento, se muestra tachado; null si no hay descuento."
                    },
                    "list_price": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Precio tal como lo fijó el dueño, en unidades mínimas de list_price_currency; null — el precio se fijó en la moneda de la tienda (price). En esa variante price lo calcula el sistema con la cotización de la lista y no se acepta en la entrada."
                    },
                    "list_price_currency": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Moneda del precio fijado (lista de la tienda en otra moneda); null — precio en la moneda de la tienda currency. En la entrada: la moneda de la lista de la tienda o currency."
                    },
                    "currency": {
                        "type": "string",
                        "description": "Moneda de los precios, código ISO 4217: la moneda de la tienda."
                    },
                    "price_per_quantity": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Por cuántas unidades es el precio, como cadena decimal: una unidad, o 1000 para el precio por kilo de una variante por peso. null si una variante por peso o volumen no lo tiene definido."
                    },
                    "measure_step": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Paso de la cantidad en un ítem de una variante por peso o volumen, en su unidad; null si no está definido."
                    },
                    "min_measure_qty": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Cantidad mínima en un ítem de una variante por peso o volumen; null si no está definida."
                    },
                    "max_measure_qty": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Cantidad máxima en un ítem de una variante por peso o volumen; null si no está definida."
                    },
                    "net_content": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "properties": {
                            "quantity": {
                                "type": "string",
                                "description": "Medida como cadena decimal en unit: \"500\", \"0.5\"."
                            },
                            "unit": {
                                "type": "string",
                                "enum": [
                                    "g",
                                    "ml"
                                ],
                                "description": "Unidad de la medida: g — gramos; ml — mililitros."
                            }
                        },
                        "required": [
                            "quantity",
                            "unit"
                        ],
                        "description": "Contenido neto de una unidad: paquete de 500 g, botella de 1000 ml. Un pack de varias unidades de otra variante lo toma de ella, una unidad envasada, de su propia medida; solo se puede escribir en una variante común por unidad. null en variantes por peso o volumen y en unidades sin contenido neto."
                    },
                    "sale_starts_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Cuándo empieza la oferta: compare_at_price se muestra desde ese momento; null — sin inicio."
                    },
                    "sale_ends_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Cuándo termina la oferta; null — sin fin."
                    },
                    "cost_price_micro": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Costo por cost_per_quantity unidades en millonésimas de la unidad mínima de currency: 1,50 USD = 150000000. Solo con el scope costs:read."
                    },
                    "cost_per_quantity": {
                        "type": "string",
                        "description": "Por cuántas unidades es el costo, como cadena decimal: la unidad de compra, por ejemplo 1000 g. Solo con el scope costs:read."
                    },
                    "track_inventory": {
                        "type": "boolean",
                        "description": "La tienda lleva el stock de la variante; false — se vende sin contar stock."
                    },
                    "stock_source_variant_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "En un pack de varias unidades de otra variante: esa variante. El pack se vende de su stock y no tiene niveles de stock propios. null en una variante común."
                    },
                    "stock_source_quantity": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Cuánto de la variante base consume una unidad del pack, como cadena decimal en la unidad de la variante base; null en una variante común."
                    },
                    "weight_grams": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Peso para el envío en gramos; null si no está definido."
                    },
                    "length_mm": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Largo del paquete en milímetros; null si no está definido."
                    },
                    "width_mm": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Ancho del paquete en milímetros; null si no está definido."
                    },
                    "height_mm": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Alto del paquete en milímetros; null si no está definido."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo se creó el registro."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo cambió el registro por última vez."
                    },
                    "deleted_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Cuándo se archivó el registro; null en un registro vigente."
                    }
                },
                "required": [
                    "id",
                    "external_id",
                    "version",
                    "product_id",
                    "sku",
                    "name",
                    "position",
                    "is_active",
                    "barcodes",
                    "option_values",
                    "sold_by",
                    "unit",
                    "quantity_decimals",
                    "price",
                    "compare_at_price",
                    "list_price",
                    "list_price_currency",
                    "currency",
                    "price_per_quantity",
                    "measure_step",
                    "min_measure_qty",
                    "max_measure_qty",
                    "net_content",
                    "sale_starts_at",
                    "sale_ends_at",
                    "track_inventory",
                    "stock_source_variant_id",
                    "stock_source_quantity",
                    "weight_grams",
                    "length_mm",
                    "width_mm",
                    "height_mm",
                    "created_at",
                    "updated_at",
                    "deleted_at"
                ]
            },
            "VariantRecipe": {
                "type": "object",
                "properties": {
                    "variant_id": {
                        "type": "integer",
                        "description": "ID de la variante a la que pertenece la receta: un plato, un preelaborado u otro ítem hecho de componentes."
                    },
                    "product_id": {
                        "type": "integer",
                        "description": "ID del producto de la variante. La receta se versiona en su ficha: ETag e If-Match llevan la versión del producto."
                    },
                    "version": {
                        "type": "integer",
                        "description": "Versión de la ficha del producto: el contador que verifica If-Match. Un cambio de la receta la mueve; la misma receta enviada otra vez, no."
                    },
                    "components": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "variant_id": {
                                    "type": "integer",
                                    "description": "ID de la variante componente: un insumo o un preelaborado de la tienda."
                                },
                                "quantity": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "description": "Cantidad del componente por porción de un plato o por tanda de un preelaborado, como texto decimal en la unidad del componente (stock_unit de su producto); null — a gusto: el componente figura pero no se descuenta."
                                },
                                "measure_mode": {
                                    "type": "string",
                                    "enum": [
                                        "fixed",
                                        "captured",
                                        "proportional"
                                    ],
                                    "description": "Cómo mide la producción el componente: fixed — la cantidad planificada; captured — se pesa al producir; proportional — se escala según un componente pesado. Solo lo lee la producción de preelaborados."
                                }
                            },
                            "required": [
                                "variant_id",
                                "quantity",
                                "measure_mode"
                            ]
                        },
                        "description": "Componentes de la receta en orden: insumos y preelaborados con su cantidad. La lista completa reemplaza la receta; una lista vacía la vacía."
                    },
                    "yield_quantity": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Rendimiento de una tanda de un preelaborado, como texto decimal en la unidad del preelaborado. Obligatorio en un preelaborado; null en un plato. Con puntos de control de rendimiento en los pasos de producción, los pasos fijan el rendimiento."
                    },
                    "option_recipes": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "option_id": {
                                    "type": "integer",
                                    "description": "ID de una opción por plato de los grupos de modificadores del producto."
                                },
                                "components": {
                                    "type": "array",
                                    "items": {
                                        "type": "object",
                                        "properties": {
                                            "variant_id": {
                                                "type": "integer",
                                                "description": "ID de la variante del producto."
                                            },
                                            "quantity": {
                                                "type": [
                                                    "string",
                                                    "null"
                                                ],
                                                "description": "Cantidad del componente por un uso de la opción, como texto decimal en la unidad del componente; null — a gusto."
                                            }
                                        },
                                        "required": [
                                            "variant_id",
                                            "quantity"
                                        ]
                                    },
                                    "description": "Qué consume la opción cuando se toma con esta variante: insumos y preelaborados con su cantidad."
                                }
                            },
                            "required": [
                                "option_id",
                                "components"
                            ]
                        },
                        "description": "Cantidades de las opciones por plato (recipe_per_variant) en esta variante: un bloque por cada opción así de los grupos del producto. Componentes vacíos — sin cantidad, y la opción no se ofrece en esta variante. Al escribir, un bloque fija la cantidad de la opción completa y los componentes vacíos la quitan; las opciones que faltan en la lista y un cuerpo sin el campo quedan como están."
                    }
                },
                "required": [
                    "variant_id",
                    "product_id",
                    "version",
                    "components",
                    "yield_quantity",
                    "option_recipes"
                ]
            },
            "WebhookDelivery": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID del registro, único entre los registros de su tipo en la tienda."
                    },
                    "endpoint_id": {
                        "type": "integer",
                        "description": "ID del endpoint del webhook."
                    },
                    "event_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "ID del evento en GET /v1/events, el mismo que webhook-id de la entrega; null en un evento de prueba."
                    },
                    "event_type": {
                        "type": "string",
                        "description": "Tipo del evento; ping en un evento de prueba."
                    },
                    "status": {
                        "type": "string",
                        "enum": [
                            "pending",
                            "succeeded",
                            "failed"
                        ],
                        "description": "pending — espera un intento; succeeded — el receptor respondió 2xx; failed — se agotaron los reintentos."
                    },
                    "attempt_count": {
                        "type": "integer",
                        "description": "Intentos realizados."
                    },
                    "next_attempt_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Cuándo sale el próximo intento; null si la entrega está cerrada."
                    },
                    "last_attempt": {
                        "anyOf": [
                            {
                                "$ref": "#/components/schemas/WebhookDeliveryAttempt"
                            },
                            {
                                "type": "null"
                            }
                        ],
                        "description": "El último intento; null antes del primero. Solo en la lista."
                    },
                    "attempts": {
                        "type": "array",
                        "items": {
                            "$ref": "#/components/schemas/WebhookDeliveryAttempt"
                        },
                        "description": "Todos los intentos en orden. Solo en una entrega."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo se creó el registro."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo cambió el registro por última vez."
                    }
                },
                "required": [
                    "id",
                    "endpoint_id",
                    "event_id",
                    "event_type",
                    "status",
                    "attempt_count",
                    "next_attempt_at",
                    "created_at",
                    "updated_at"
                ]
            },
            "WebhookDeliveryAttempt": {
                "type": "object",
                "properties": {
                    "number": {
                        "type": "integer",
                        "description": "Número del intento, desde 1."
                    },
                    "manual": {
                        "type": "boolean",
                        "description": "El intento se hizo por una solicitud de reintento, no por el calendario."
                    },
                    "started_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo empezó el intento."
                    },
                    "duration_ms": {
                        "type": "integer",
                        "description": "Cuánto duró el intento, en milisegundos."
                    },
                    "response_status": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Estado HTTP con el que respondió el receptor; null si no hubo respuesta."
                    },
                    "response_body": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Comienzo del cuerpo de la respuesta del receptor; null si no hubo cuerpo."
                    },
                    "error": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "enum": [
                            "invalid_url",
                            "blocked",
                            "dns",
                            "connection",
                            "tls",
                            "timeout",
                            "unreachable",
                            "redirect",
                            "http_error",
                            null
                        ],
                        "description": "Por qué falló el intento; null si el receptor respondió 2xx. redirect — una respuesta 3xx, las redirecciones no se siguen; http_error — otro estado; timeout — no hubo respuesta en 10 segundos; tls, connection, dns, unreachable — la red; blocked — la dirección lleva a una red interna; invalid_url — la dirección no pasa la verificación."
                    }
                },
                "required": [
                    "number",
                    "manual",
                    "started_at",
                    "duration_ms",
                    "response_status",
                    "response_body",
                    "error"
                ]
            },
            "WebhookEndpoint": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID del registro, único entre los registros de su tipo en la tienda."
                    },
                    "version": {
                        "type": "integer",
                        "description": "Versión del registro: crece con cada cambio. Para cambiar el registro, envíela como ETag en If-Match."
                    },
                    "url": {
                        "type": "string",
                        "description": "Dirección HTTPS a la que se envían las entregas."
                    },
                    "description": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Descripción del endpoint; null si no se indicó."
                    },
                    "enabled_events": {
                        "type": "array",
                        "items": {
                            "type": "string"
                        },
                        "description": "Tipos de evento a los que está suscripto el endpoint, como order.created; son los tipos de GET /v1/events. Un tipo cuyo scope de lectura perdió la aplicación no se entrega."
                    },
                    "api_version": {
                        "type": "string",
                        "const": "v1",
                        "description": "Versión de la API cuyo formato sigue el cuerpo de las entregas, fijada al crear el endpoint."
                    },
                    "status": {
                        "type": "string",
                        "enum": [
                            "enabled",
                            "disabled"
                        ],
                        "description": "enabled — las entregas salen; disabled — lo desactivó la aplicación o la plataforma (disabled_reason)."
                    },
                    "disabled_reason": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "enum": [
                            "failing",
                            null
                        ],
                        "description": "Por qué la plataforma desactivó el endpoint: failing — durante 72 horas las entregas no tuvieron ni un éxito. null si está activo o si lo desactivó la aplicación. Activarlo borra el motivo."
                    },
                    "failing_since": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Desde cuándo las entregas al endpoint no tienen ni un éxito; a las 72 horas la plataforma lo desactiva. null si la última entrega tuvo éxito."
                    },
                    "previous_secret_expires_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Después de rotar el secreto, las entregas se firman también con el anterior hasta este momento; null si no hay secreto anterior."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo se creó el registro."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo cambió el registro por última vez."
                    }
                },
                "required": [
                    "id",
                    "version",
                    "url",
                    "description",
                    "enabled_events",
                    "api_version",
                    "status",
                    "disabled_reason",
                    "failing_since",
                    "previous_secret_expires_at",
                    "created_at",
                    "updated_at"
                ]
            },
            "WebhookEndpointSecret": {
                "type": "object",
                "properties": {
                    "endpoint_id": {
                        "type": "integer",
                        "description": "ID del endpoint del webhook."
                    },
                    "secret": {
                        "type": "string",
                        "description": "Secreto de firma según Standard Webhooks: whsec_ y la clave base64 de HMAC-SHA256. Guardalo solo en tu servidor."
                    }
                },
                "required": [
                    "endpoint_id",
                    "secret"
                ]
            },
            "WriteOffReason": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "description": "ID del registro, único entre los registros de su tipo en la tienda."
                    },
                    "name": {
                        "type": "object",
                        "additionalProperties": {
                            "type": "string"
                        },
                        "description": "Nombre por idioma: un objeto con los idiomas completados, por ejemplo {\"es\": \"Café\", \"en\": \"Coffee\"}."
                    },
                    "kind": {
                        "type": "string",
                        "enum": [
                            "spoilage",
                            "shrinkage",
                            "internal_use"
                        ],
                        "description": "Tipo contable de la baja: spoilage — mercadería vencida o dañada; shrinkage — mercadería faltante; internal_use — la tienda usó la mercadería para sí."
                    },
                    "requires_comment": {
                        "type": "boolean",
                        "description": "Una baja con este motivo exige un comentario."
                    },
                    "selectable": {
                        "type": "boolean",
                        "description": "El motivo se puede indicar en una baja nueva: no está archivado ni es un motivo del sistema que solo registra la propia tienda."
                    },
                    "position": {
                        "type": "integer",
                        "description": "Posición en el orden: la menor va primero."
                    },
                    "archived_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Cuándo se archivó el motivo; null en un motivo vigente. Un motivo archivado sigue en la lista: las bajas pasadas lo nombran."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo se creó el registro."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Cuándo cambió el registro por última vez."
                    }
                },
                "required": [
                    "id",
                    "name",
                    "kind",
                    "requires_comment",
                    "selectable",
                    "position",
                    "archived_at",
                    "created_at",
                    "updated_at"
                ]
            }
        },
        "responses": {
            "Unauthenticated": {
                "description": "Falta el token, es inválido, venció o fue revocado",
                "headers": {
                    "WWW-Authenticate": {
                        "$ref": "#/components/headers/WwwAuthenticate"
                    },
                    "X-Request-Id": {
                        "$ref": "#/components/headers/RequestId"
                    }
                },
                "content": {
                    "application/problem+json": {
                        "schema": {
                            "$ref": "#/components/schemas/Problem"
                        }
                    }
                }
            },
            "Forbidden": {
                "description": "El plan, la dirección IP o los scopes del token no permiten la solicitud",
                "headers": {
                    "WWW-Authenticate": {
                        "$ref": "#/components/headers/WwwAuthenticateOptional"
                    },
                    "X-Request-Id": {
                        "$ref": "#/components/headers/RequestId"
                    }
                },
                "content": {
                    "application/problem+json": {
                        "schema": {
                            "$ref": "#/components/schemas/ForbiddenProblem"
                        }
                    }
                }
            },
            "NotFound": {
                "description": "El objeto no existe o no está disponible para la aplicación",
                "headers": {
                    "X-Request-Id": {
                        "$ref": "#/components/headers/RequestId"
                    }
                },
                "content": {
                    "application/problem+json": {
                        "schema": {
                            "$ref": "#/components/schemas/Problem"
                        }
                    }
                }
            },
            "Conflict": {
                "description": "Hay una solicitud en curso con la misma clave de idempotencia, los datos cambiaron después de leerlos, el ID externo pertenece a otro registro, se alcanzó el límite del plan o de endpoints de webhook, o el cambio necesita consentir sus consecuencias",
                "headers": {
                    "Retry-After": {
                        "$ref": "#/components/headers/RetryAfterOptional"
                    },
                    "X-Request-Id": {
                        "$ref": "#/components/headers/RequestId"
                    }
                },
                "content": {
                    "application/problem+json": {
                        "schema": {
                            "$ref": "#/components/schemas/ConflictProblem"
                        }
                    }
                }
            },
            "PreconditionFailed": {
                "description": "El registro cambió después de leerlo: la versión de If-Match no es la actual",
                "headers": {
                    "X-Request-Id": {
                        "$ref": "#/components/headers/RequestId"
                    }
                },
                "content": {
                    "application/problem+json": {
                        "schema": {
                            "$ref": "#/components/schemas/Problem"
                        }
                    }
                }
            },
            "PreconditionRequired": {
                "description": "La solicitud necesita If-Match con el ETag del registro",
                "headers": {
                    "X-Request-Id": {
                        "$ref": "#/components/headers/RequestId"
                    }
                },
                "content": {
                    "application/problem+json": {
                        "schema": {
                            "$ref": "#/components/schemas/Problem"
                        }
                    }
                }
            },
            "RangeNotSatisfiable": {
                "description": "El rango empieza después del resultado escrito",
                "headers": {
                    "Content-Range": {
                        "$ref": "#/components/headers/ContentRange"
                    },
                    "X-Request-Id": {
                        "$ref": "#/components/headers/RequestId"
                    }
                },
                "content": {
                    "application/problem+json": {
                        "schema": {
                            "$ref": "#/components/schemas/Problem"
                        }
                    }
                }
            },
            "CursorExpired": {
                "description": "El cursor de sincronización supera el plazo de conservación de eliminaciones o se emitió antes de restaurar la base de datos",
                "headers": {
                    "X-Request-Id": {
                        "$ref": "#/components/headers/RequestId"
                    }
                },
                "content": {
                    "application/problem+json": {
                        "schema": {
                            "$ref": "#/components/schemas/Problem"
                        }
                    }
                }
            },
            "ValidationFailed": {
                "description": "Un parámetro es inválido o desconocido",
                "headers": {
                    "X-Request-Id": {
                        "$ref": "#/components/headers/RequestId"
                    }
                },
                "content": {
                    "application/problem+json": {
                        "schema": {
                            "$ref": "#/components/schemas/ValidationProblem"
                        }
                    }
                }
            },
            "TooManyRequests": {
                "description": "Se agotó el límite de solicitudes",
                "headers": {
                    "Retry-After": {
                        "$ref": "#/components/headers/RetryAfter"
                    },
                    "RateLimit": {
                        "$ref": "#/components/headers/RateLimit"
                    },
                    "RateLimit-Policy": {
                        "$ref": "#/components/headers/RateLimitPolicy"
                    },
                    "X-Request-Id": {
                        "$ref": "#/components/headers/RequestId"
                    }
                },
                "content": {
                    "application/problem+json": {
                        "schema": {
                            "$ref": "#/components/schemas/RateLimitProblem"
                        }
                    }
                }
            },
            "ServiceUnavailable": {
                "description": "La tienda no está disponible por ahora",
                "headers": {
                    "Retry-After": {
                        "$ref": "#/components/headers/RetryAfterOptional"
                    },
                    "X-Request-Id": {
                        "$ref": "#/components/headers/RequestId"
                    }
                },
                "content": {
                    "application/problem+json": {
                        "schema": {
                            "$ref": "#/components/schemas/Problem"
                        }
                    }
                }
            }
        },
        "parameters": {
            "AcceptLanguage": {
                "name": "Accept-Language",
                "in": "header",
                "required": false,
                "description": "Idioma de los textos de error: es, en o ru. Inglés por defecto.",
                "schema": {
                    "type": "string",
                    "examples": [
                        "es"
                    ]
                }
            },
            "IdempotencyKey": {
                "name": "Idempotency-Key",
                "in": "header",
                "required": false,
                "description": "Clave única del intento, por ejemplo un UUID. Un reintento con la misma clave y el mismo cuerpo recibe la respuesta guardada en vez de escribir dos veces. Las claves duran 24 horas.",
                "schema": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 255,
                    "examples": [
                        "8e03978e-40d5-43e8-bc93-6894a57f9324"
                    ]
                }
            },
            "IdempotencyKeyRequired": {
                "name": "Idempotency-Key",
                "in": "header",
                "required": true,
                "description": "Clave obligatoria del intento, por ejemplo un UUID: un duplicado de este comando ante el fisco no se deshace. Un reintento con la misma clave y el mismo cuerpo recibe la respuesta guardada. Las claves duran 24 horas.",
                "schema": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 255,
                    "examples": [
                        "8e03978e-40d5-43e8-bc93-6894a57f9324"
                    ]
                }
            },
            "IfMatch": {
                "name": "If-Match",
                "in": "header",
                "required": true,
                "description": "ETag del registro de la última lectura, por ejemplo \"7\". El cambio se aplica solo si nadie cambió el registro desde entonces; si no, 412. Sin él, 428.",
                "schema": {
                    "type": "string",
                    "examples": [
                        "\"7\""
                    ]
                }
            },
            "IfMatchUpsert": {
                "name": "If-Match",
                "in": "header",
                "required": false,
                "description": "ETag del registro de la última lectura. Es obligatorio si ya existe un registro con este ID externo (si no, 428) y no tiene que estar si no existe.",
                "schema": {
                    "type": "string",
                    "examples": [
                        "\"7\""
                    ]
                }
            },
            "IfNoneMatch": {
                "name": "If-None-Match",
                "in": "header",
                "required": false,
                "description": "* — solo crear: si ya existe un registro con este ID externo, la solicitud recibe 412.",
                "schema": {
                    "type": "string",
                    "enum": [
                        "*"
                    ]
                }
            },
            "Range": {
                "name": "Range",
                "in": "header",
                "required": false,
                "description": "Un rango de bytes para reanudar la descarga: bytes=<desde>- o bytes=<desde>-<hasta>. El resultado de una operación en curso solo crece: seguí con bytes=<descargado>- sin If-Range; 416 significa que todavía no hay líneas nuevas. Varios rangos reciben el resultado entero.",
                "schema": {
                    "type": "string",
                    "examples": [
                        "bytes=1048576-"
                    ]
                }
            },
            "IfRange": {
                "name": "If-Range",
                "in": "header",
                "required": false,
                "description": "ETag del resultado de la respuesta anterior. El rango se entrega solo si desde entonces no se agregó nada; si no, el resultado entero (200).",
                "schema": {
                    "type": "string",
                    "examples": [
                        "\"52428800\""
                    ]
                }
            }
        },
        "headers": {
            "RateLimit": {
                "description": "Solicitudes que pasan seguidas y segundos hasta que el cupo vuelve a estar lleno, por política.",
                "required": true,
                "schema": {
                    "type": "string",
                    "examples": [
                        "\"app\";r=87;t=3, \"store\";r=390;t=1"
                    ]
                }
            },
            "RateLimitPolicy": {
                "description": "Políticas de límite: cupo por ventana en segundos.",
                "required": true,
                "schema": {
                    "type": "string",
                    "examples": [
                        "\"app\";q=300;w=60, \"store\";q=1200;w=60"
                    ]
                }
            },
            "RequestId": {
                "description": "ID de la solicitud. Indicalo cuando escribas a soporte.",
                "required": true,
                "schema": {
                    "type": "string"
                }
            },
            "IdempotentReplayed": {
                "description": "true cuando es la respuesta guardada de una solicitud anterior con el mismo Idempotency-Key.",
                "required": false,
                "schema": {
                    "type": "string",
                    "enum": [
                        "true"
                    ]
                }
            },
            "ETag": {
                "description": "Versión del registro. Mandala en If-Match para cambiar el registro.",
                "required": true,
                "schema": {
                    "type": "string",
                    "examples": [
                        "\"7\""
                    ]
                }
            },
            "Location": {
                "description": "Dirección del registro creado; en una solicitud aceptada (202), la dirección donde seguir su resultado.",
                "required": true,
                "schema": {
                    "type": "string",
                    "format": "uri"
                }
            },
            "AcceptRanges": {
                "description": "bytes: el resultado se entrega por rangos. Una respuesta comprimida (Content-Encoding: gzip) no trae este encabezado: no se puede reanudar.",
                "required": false,
                "schema": {
                    "type": "string",
                    "enum": [
                        "bytes"
                    ]
                }
            },
            "ContentRange": {
                "description": "El rango entregado y la longitud escrita: bytes 0-1023/52428800; en 416, bytes */52428800.",
                "required": true,
                "schema": {
                    "type": "string",
                    "examples": [
                        "bytes 1048576-52428799/52428800"
                    ]
                }
            },
            "ResultETag": {
                "description": "Etiqueta del resultado, distinta cada vez que el resultado crece. Mandala en If-Range para reanudar la misma versión. Una respuesta comprimida trae una etiqueta débil (W/) que no sirve en If-Range.",
                "required": true,
                "schema": {
                    "type": "string",
                    "examples": [
                        "\"52428800\""
                    ]
                }
            },
            "RetryAfter": {
                "description": "Segundos de espera antes de reintentar.",
                "required": true,
                "schema": {
                    "type": "integer",
                    "minimum": 0
                }
            },
            "RetryAfterOptional": {
                "description": "Segundos de espera antes de reintentar.",
                "required": false,
                "schema": {
                    "type": "integer",
                    "minimum": 0
                }
            },
            "WwwAuthenticate": {
                "description": "Esquema de autenticación (RFC 6750).",
                "required": true,
                "schema": {
                    "type": "string",
                    "examples": [
                        "Bearer"
                    ]
                }
            },
            "WwwAuthenticateOptional": {
                "description": "Esquema de autenticación (RFC 6750).",
                "required": false,
                "schema": {
                    "type": "string",
                    "examples": [
                        "Bearer error=\"insufficient_scope\", scope=\"locations:read\""
                    ]
                }
            }
        },
        "securitySchemes": {
            "apiToken": {
                "type": "http",
                "scheme": "bearer",
                "description": "Token de la aplicación de la configuración de la tienda, en Authorization: Bearer <token>."
            }
        }
    }
}
