Cupo de ventas locales y excedente

Cada pedido creado por la API cuenta como una venta local de tu florería: consume el cupo de ventas locales de tu plan y, pasado el cupo, genera un cargo por excedente que se descuenta en tu liquidación. Es el mismo cobro que una venta local cargada a mano en el panel; la API no tiene un cupo ni una tarifa aparte.

Una integración consume el cupo más rápido

Cargando a mano una florería ingresa pocas ventas locales. Una tienda integrada puede mandar todos sus pedidos y agotar el cupo gratis en pocos días. Revisa tu plan antes de activar la integración.

Consultar el cupo

GET /me informa:

Campo	Qué es
free_orders_remaining	Ventas locales gratis que te quedan en el período
next_order_cost	Lo que costaría el próximo pedido (0 si queda cupo)
pending_count	Excedentes sin liquidar
pending_limit	Máximo de excedentes sin liquidar que permite tu plan
is_blocked	true si ya no puedes crear pedidos por excedentes pendientes
orders_write_enabled	Si la florería puede crear pedidos por la API

Bloqueo por excedente

Si acumulas excedentes sin liquidar hasta pending_limit, los POST /orders nuevos responden 422 internal_orders_blocked (con pending_count y pending_limit) y no se crea nada hasta que liquides esas ventas. El bloqueo corta la integración entera, no un formulario: consulta GET /me periódicamente y avisa a tu operador antes de llegar al límite.

Cancelaciones

Cancelar un pedido no devuelve su cargo de excedente.