Cargando el índice de búsqueda…

Desarrolladores

Registro de cambios de la API

Cada cambio del contrato /v1: endpoints y campos nuevos, correcciones y obsolescencias. Un cambio dentro de /v1 nunca rompe un cliente que ignora los campos desconocidos.

  • Política de versiones

    Dentro de /v1 nada se elimina ni se renombra, y lo que funcionaba sigue funcionando. Un cambio que rompe llega como una versión nueva, anunciada acá con anticipación.

    Versiones de la API →
  • Seguí los cambios

    Suscribite al feed Atom en tu lector de feeds o en el chat de tu equipo: cada entrada nueva aparece ahí el mismo día en que se publica.

    Feed Atom
  1. Corrección

    Las listas devuelven los registros cuya referencia vació una eliminación

    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.

    Endpoints

  2. Cambio

    Retenciones al pagar comprobantes de proveedor: jurisdicción y moneda

    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.

    Endpoints

  3. Nuevo

    Traslados entre tiendas del grupo en el diario de stock

    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.

    Endpoints

  4. Nuevo

    Comprobante de la caja externa en pedidos

    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.

    Endpoints

  5. Nuevo

    Escritura de comprobantes fiscales

    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.

    Endpoints

  6. Nuevo

    Listas de precios mayoristas

    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.

    Endpoints

  7. Nuevo

    Escritura de listas de precios

    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.

    Endpoints

  8. Nuevo

    Listas de precios

    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.

    Endpoints

  9. Nuevo

    Grupos de clientes

    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.

    Endpoints

  10. Nuevo

    Número de seguimiento de un servicio sin integración

    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.

    Endpoints

  11. Nuevo

    Emisión del envío por la API

    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.

    Endpoints

  12. Nuevo

    Precio de la variante en la moneda de la lista

    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.

    Endpoints

  13. Nuevo

    Horario de venta del producto

    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.

    Endpoints

  14. Nuevo

    Envío con el transportista en el pedido

    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.

    Endpoints

  15. Nuevo

    Composición de los descuentos del pedido

    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.

    Endpoints

  16. Nuevo

    Traslados e inventarios

    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.

    Endpoints

  17. Cambio

    Vinculación de la cotización en la factura del pago

    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.

    Endpoints

  18. Nuevo

    Diario de movimientos de stock y lotes

    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.

    Endpoints

  19. Nuevo

    Libros IVA y paquete del contador como archivo

    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.

    Endpoints

  20. Nuevo

    Pago de comprobantes de proveedor fuera del sistema

    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.

    Endpoints

  21. Nuevo

    Aprobación de pago de comprobantes de proveedores

    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.

    Endpoints

  22. Nuevo

    Contenido neto de la unidad de la variante

    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.

    Endpoints

  23. Nuevo

    Escritura de comprobantes de proveedores

    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.

    Endpoints

  24. Nuevo

    Escritura de órdenes de compra

    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.

    Endpoints

  25. Nuevo

    Modificadores

    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.

    Endpoints

  26. Nuevo

    Escritura de proveedores

    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.

    Endpoints

  27. Nuevo

    Insumos, preelaborados y recetas

    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.

    Endpoints

  28. Nuevo

    Retenciones y percepciones

    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.

    Endpoints

  29. Nuevo

    Liquidaciones de consignación

    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.

    Endpoints

  30. Nuevo

    Órdenes de compra, recepciones y devoluciones a proveedores

    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.

    Endpoints

  31. Nuevo

    Saldos, conciliación y compensaciones

    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.

    Endpoints

  32. Nuevo

    Proveedores y comprobantes de proveedores

    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.

    Endpoints

  33. Nuevo

    Escritura del libro de dinero y cobros de cuentas corrientes

    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.

    Endpoints

  34. Nuevo

    Cuentas corrientes de clientes

    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.

    Endpoints

  35. Nuevo

    Tarjetas de regalo y sus movimientos

    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.

    Endpoints

  36. Nuevo

    Turnos de caja y diario del cajón

    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.

    Endpoints

  37. Nuevo

    Cotización contable del día

    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.

    Endpoints

  38. Nuevo

    Libro de dinero: cuentas, categorías y movimientos

    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.

    Endpoints

  39. Nuevo

    Comisión del proveedor e impuesto retenido del pago

    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.

    Endpoints

  40. Nuevo

    Dinero del pago, razón social de la venta y eventos de pagos y reembolsos

    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.

    Endpoints

  41. Nuevo

    Razones sociales, comprobantes fiscales y períodos fiscales

    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.

    Endpoints

  42. Nuevo

    Impuesto de la venta y costo de los ítems de pedidos

    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.

    Endpoints

  43. Nuevo

    Clases de impuesto de los productos

    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.

    Endpoints

  44. Nuevo

    Consentimiento de publicidad por canal

    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.

    Endpoints

  45. Obsoleto

    accepts_marketing y marketing_consent_at están obsoletos

    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.

    Endpoints

  46. Nuevo

    Factura de renovación de membresía

    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.

    Endpoints

  47. Nuevo

    Moneda del total al confirmar un borrador

    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.

    Endpoints

  48. Nuevo

    Vencimiento de paquetes de visitas

    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.

    Endpoints

  49. Nuevo

    Tipos de error de cada endpoint

    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.

  50. Cambio

    Límite de solicitudes rechazadas

    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.

  51. Nuevo

    Visitas de paquetes

    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.

    Endpoints

  52. Nuevo

    Paquetes de visitas

    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.

    Endpoints

  53. Lanzamiento

    API de integraciones v1

    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.