Suscripciones
La suscripción es el plan que tiene contratado cada cliente: su vigencia, sus folios y su estatus. La de cada cliente nace al darlo de alta con un plan; aquí la consultas y la administras. Los folios tienen su propia página: Folios.
Todas las peticiones de esta página llevan Authorization: Bearer <token> (ver
Autenticación). Agrega F-Sandbox-Mode: true para
trabajar en sandbox.
Consultar suscripciones
Devuelve las suscripciones de todos tus clientes. De aquí sale el uuid de cada
suscripción, que usan el resto de operaciones de esta página.
curl https://invoice.taxo.ws/mx/partners/v1/subscriptions \
-H "Authorization: Bearer <token>" \
-H "F-Sandbox-Mode: true"
Ver una suscripción
Devuelve la suscripción en data, o 404 si no existe.
curl https://invoice.taxo.ws/mx/partners/v1/subscriptions/<uuid-de-la-suscripcion> \
-H "Authorization: Bearer <token>" \
-H "F-Sandbox-Mode: true"
Los valores son de ejemplo:
{
"response": "success",
"data": {
"uuid": "<uuid-de-la-suscripcion>",
"name": "Plan especial",
"start_date": "2026-10-01T00:00:00Z",
"end_date": "2026-11-01T00:00:00Z",
"folios": 100,
"folios_used": 12,
"status": "<estatus>",
"vigency": "Mensual",
"client": {
"uuid": "<uuid-del-cliente>",
"name": "MARTIN LOPEZ",
"email": "[email protected]",
"status": "<estatus>"
},
"product": {
"uuid": "<uuid-del-plan>",
"name": "Plan especial",
"status": "<estatus>"
}
}
}
El objeto suscripción
| Campo | Tipo | Descripción |
|---|---|---|
uuid | texto | Identificador de la suscripción. |
name | texto | Nombre de la suscripción. |
start_date | fecha | Inicio de la vigencia. |
end_date | fecha | Fin de la vigencia. |
folios | entero | Folios de la suscripción. |
folios_used | entero | Folios ya utilizados. |
status | texto | Estatus de la suscripción. |
vigency | texto | Vigencia contratada. |
client | objeto | Cliente: uuid, name, email y status. |
product | objeto | Plan: uuid, name y status. |
Renovar una suscripción
Extiende la vigencia de la suscripción con el plan y la vigencia que indiques.
Responde con la suscripción renovada en data, o 422 si algún dato no es válido.
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
product_uuid | texto | Sí | uuid del plan. |
vigency_uuid | texto | Sí | uuid de la vigencia del plan. |
curl https://invoice.taxo.ws/mx/partners/v1/subscriptions/<uuid-de-la-suscripcion>/renew \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-H "F-Sandbox-Mode: true" \
-d '{
"product_uuid": "<uuid-del-plan>",
"vigency_uuid": "<uuid-de-la-vigencia>"
}'
Suspender suscripciones
Suspende una o varias suscripciones activas. Responde 404 si alguna no existe.
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
uuids | arreglo | Sí | uuid de las suscripciones a suspender. |
message | texto | No | Mensaje para el cliente. |
keep_folios | booleano | No | Si los folios disponibles deben conservarse. |
curl https://invoice.taxo.ws/mx/partners/v1/subscriptions/suspend \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-H "F-Sandbox-Mode: true" \
-d '{
"uuids": ["<uuid-de-la-suscripcion>"],
"keep_folios": true
}'
Reactivar suscripciones
Reactiva una o varias suscripciones suspendidas. Envía sus identificadores en
uuids. Responde 404 si alguna no existe.
curl https://invoice.taxo.ws/mx/partners/v1/subscriptions/reactivate \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-H "F-Sandbox-Mode: true" \
-d '{ "uuids": ["<uuid-de-la-suscripcion>"] }'