Folios
Consulta, agrega y retira los folios de la suscripción de un cliente.
Los folios son los comprobantes que un cliente puede timbrar. Viven en su suscripción: el plan asigna los folios de cada vigencia, y desde aquí puedes agregar o retirar folios sin cambiar de plan.
Todas las peticiones de esta página llevan Authorization: Bearer <token> (ver
Autenticación). Agrega F-Sandbox-Mode: true para
trabajar en sandbox.
Consultar los folios de un cliente
Los folios se leen en la suscripción del cliente, con Ver una suscripción:
| Campo | Descripción |
|---|---|
folios | Folios de la suscripción. |
folios_used | Folios ya utilizados. |
Agregar folios
POSThttps://invoice.taxo.ws/mx/partners/v1/subscriptions/{uuid}/add-folios
Agrega folios a la suscripción indicada. Responde 200 si se agregan, o 422 si
algún dato no es válido.
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
folios | entero | Sí | Cantidad de folios a agregar. |
amount | número | Sí | Monto de los folios que se agregan. |
cURL
curl https://invoice.taxo.ws/mx/partners/v1/subscriptions/<uuid-de-la-suscripcion>/add-folios \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-H "F-Sandbox-Mode: true" \
-d '{ "folios": 5, "amount": 2.99 }'
Retirar folios
POSThttps://invoice.taxo.ws/mx/partners/v1/subscriptions/{uuid}/remove-folios
Retira folios de la suscripción indicada. Responde 200 si se retiran, o 422 si
algún dato no es válido.
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
folios | entero | Sí | Cantidad de folios a retirar. |
cURL
curl https://invoice.taxo.ws/mx/partners/v1/subscriptions/<uuid-de-la-suscripcion>/remove-folios \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-H "F-Sandbox-Mode: true" \
-d '{ "folios": 4 }'
Folios al suspender
Al suspender un cliente o una
suscripción, el campo
keep_folios indica si los folios disponibles deben conservarse.