Ir al contenido
Cuenta

FISCALISTO / API / REFERENCIA

Cambiar la versión de la API

POST
/v1/account

Mueve la versión de la API de la cuenta: la que reciben sus solicitudes sin el encabezado Fiscalisto-Version y sus webhooks sin api_version propio. Antes, pruebe la nueva mandando Fiscalisto-Version en sus solicitudes. Con una llave de la cuenta con todos los permisos (no de un entorno de prueba). Queda en Desarrolladores › Actividad.

Autorización

bearerAuth
headerAutorizaciónBearer <llave>

Su llave secreta: fk_test_… en pruebas, fk_live_… en producción. Desarrolladores › Llaves.

Encabezados

Idempotency-Key?string

Opcional (los SDK la mandan solos). Si la respuesta se pierde, repita la solicitud con el mismo valor durante 24 horas: contesta lo mismo, con idempotent-replayed: true, y no lo hace dos veces (ni crea, ni manda correos, ni cobra).

Longitud1 <= length <= 255

Cuerpo de la solicitud

application/json
  1. body
api_version*string

La versión de la API de la cuenta: la que reciben sus solicitudes sin Fiscalisto-Version y sus webhooks sin api_version propio. Pruebe antes la nueva con el encabezado.

Cuerpo de la respuesta

Correcto.

application/json
  1. response

La cuenta API de la llave que hizo la solicitud.

id*string

Identificador del objeto, con su prefijo (iss_, inv_, ret_, cus_, prd_, emp_, bat_, brn_, whs_, stm_, adj_, evt_, whe_).

livemode*boolean

true en producción (llaves fk_live_), false en pruebas (fk_test_). Lo de pruebas no vale ante el SAT.

object*string

Qué tipo de objeto es («invoice», «customer»…).

name*string

El nombre de la cuenta API.

api_version*string

La versión de la API de la cuenta (la de sus solicitudes sin Fiscalisto-Version). Ver Versiones.

latest_api_version*string

La versión más reciente de la API.

key*

La llave con que se hizo la solicitud: id, nombre y emisores a los que se limita.

curl -X POST 'https://api.fiscalisto.com/v1/account' \  -H 'Authorization: Bearer fk_test_…' \  -H 'Idempotency-Key: 8f14e45f-ceea-467a-9575-6a1b0e5f3c21' \  -H 'Content-Type: application/json' \  -d '{  "api_version": "2026-10-24"}'
{  "id": "org_39c5a6b2-02b3-8453-9c35-aba6b43c876a",  "object": "account",  "livemode": false,  "name": "Mi plataforma",  "api_version": "2026-10-24",  "latest_api_version": "2026-10-24",  "key": {    "id": "key_vFQbeTxgHVoTlowHaTLR",    "name": "Pruebas",    "issuers": null,    "read_only": false,    "expires_at": null,    "sandbox": null  }}