API
Idioma
Pide tu lugar

Beta cerrada. Todavía no se puede llamar a nada. Esta documentación describe el contrato del primer día, y los nombres marcados como propuesto pueden cambiar antes de que abra la beta. Pide tu lugar

Docs · Referencia

Contabilidad

Transacciones de contabilidad, cada una con su categoría y su estado.

Listar las transacciones de contabilidad

GET/v1/bookkeeping/transactions

Transacciones del libro mayor, de tarjeta e importadas, cada una con su categoría y su estado contable.

Autenticación

Token bearer cuyo cliente tiene el scope bookkeeping:read

Parámetros

cursorquery · string

El next_cursor de la página anterior. Es opaco: no lo construyas ni lo modifiques

limitquery · integer

Filas por página

mín. 1 · máx. 100 · por defecto 50

fromquery · string

Fecha más antigua, incluida

date

toquery · string

Fecha más reciente

date

statusquery · string

Solo un estado contable

category_idquery · string

Solo las transacciones de esta categoría

Respuesta · una lista de BookkeepingTransaction

dataarray of BookkeepingTransaction

La página de resultados

next_cursorstring or null

Pásalo como cursor para obtener la página siguiente. null en la última página

Cada elemento de data:

idstringobligatorio

El id de la transacción de contabilidad

datestringobligatorio

Fecha de la transacción

date

amountMoneyobligatorio

Importe movido

amount.amountstringobligatorio

Cadena decimal con dos decimales, nunca negativa. El campo direction indica en qué sentido se movió

patrón ^[0-9]+\.[0-9]{2}$

amount.currencystringobligatorio

Siempre USD

Uno de USD

directionstringobligatorio

Dinero que entra (credit) o que sale (debit)

Uno de creditdebit

sourcestringobligatorio

De dónde vino

Uno de ledgercardimported

statusstringobligatorio

Estado contable

descriptionstringtexto no confiable

Descripción del comercio, el pagador o el banco

categoryCategoryRef

Categoría de la transacción

category.idstring

El id de la categoría. Puede cambiar durante la beta cerrada

category.namestringtexto no confiable

El nombre de la categoría. No confiable cuando la creó el titular

notesstringtexto no confiable

Nota añadida en Novo

Respuestas

  • 200OK
  • 401Falta el token, venció o es desconocido, o el cliente se revocó o se desactivó
  • 403Al cliente le falta el scope, la situación del titular cambió o la API no está habilitada para este negocio
  • 429Demasiadas solicitudes. Espera lo que indique Retry-After
  • 500Algo falló de forma inesperada del lado de Novo. No se puede reintentar: menciona request_id a soporte
  • 503Algo de lo que depende la respuesta no está disponible. Reintenta después de Retry-After
Solicitud
curl "https://$NOVO_API_HOST/v1/bookkeeping/transactions" \
  -H "Authorization: Bearer $ACCESS_TOKEN"
Respuesta · 200
{
  "data": [
    {
      "id": "bkt_example_01",
      "date": "2026-10-01",
      "amount": {
        "amount": "84.20",
        "currency": "USD"
      },
      "direction": "debit",
      "source": "card",
      "status": "EXAMPLE_STATUS",
      "description": "EXAMPLE MERCHANT",
      "category": {
        "id": "cat_example_01",
        "name": "Supplies"
      }
    }
  ],
  "next_cursor": "example_cursor"
}

Previsto para contabilidad

  • Subir recibos

Todavía no está disponible, y no se publica ningún endpoint para esto. Aparecerán aquí cuando el contrato los defina. Todo lo marcado como “requiere tu aprobación” espera a que el titular de la cuenta lo apruebe en su teléfono, cada vez. Dinos qué necesitas primero cuando pidas tu lugar.