ByDomuDevelopers
Criar chave

Detalle de registro contable

GEThttps://api.bydomu.com/v1/accounting/{id}

Esta referência é gerada a partir do código da API, por isso as descrições estão em espanhol. Nomes, parâmetros e exemplos são iguais em qualquer idioma.

El registro con su categoría, negocio, contacto y quién lo creó, aprobó o anuló.

Permissão
accounting:read
Chaves
Só secreta (de um servidor)

Cabeçalhos

X-API-Keystringobrigatório
Sua chave secreta.

Parâmetros de rota

idstringobrigatório
ID del registro

Respostas

200El registro
401UNAUTHORIZED · Clave faltante, inválida, desactivada o vencida.
403FORBIDDEN · La clave no puede usar esta operación: falta el scope, es una secreta en el navegador, el nivel de la cuenta no la permite, está suspendida o se alcanzó un tope del plan.
404NOT_FOUND · El recurso no existe en la organización.
429RATE_LIMITED · Límite de peticiones excedido: el de la clave (`RATE_LIMITED`), el de escrituras de la organización (`TENANT_RATE_LIMITED`) o bloqueo temporal de la IP por claves inválidas.
500INTERNAL_ERROR · Error interno del servidor.
cURL
curl "https://api.bydomu.com/v1/accounting/clx1acc001" \
  -H "X-API-Key: $BYDOMU_API_KEY"
JavaScript
const res = await fetch("https://api.bydomu.com/v1/accounting/clx1acc001", {
  headers: { "X-API-Key": process.env.BYDOMU_API_KEY },
});
const data = await res.json();
Python
import os, requests

r = requests.get(
    "https://api.bydomu.com/v1/accounting/clx1acc001",
    headers={"X-API-Key": os.environ["BYDOMU_API_KEY"]}
)
data = r.json()
Resposta · 200 · exemplo
{
  "data": {
    "id": "clx1acc001",
    "referenceNumber": "ING-2026-0042",
    "type": "INGRESO",
    "status": "BORRADOR",
    "description": "Comisión por venta Apto Chapinero",
    "amount": "9345000.00",
    "currency": "COP",
    "entryDate": "2026-09-20T00:00:00.000Z",
    "approvedAt": "2026-09-21T09:00:00.000Z",
    "notes": "Aprobado por dirección comercial",
    "attachmentUrl": "https://cdn.bydomu.com/docs/soporte.pdf",
    "reimbursable": false,
    "categoryId": "clx1cat001",
    "dealId": "clx1deal001",
    "contactId": "clx1con001",
    "createdById": "clx1usr001",
    "approvedById": "clx1usr002",
    "voidedAt": "2026-09-22T00:00:00.000Z",
    "voidReason": "Registro duplicado",
    "createdAt": "2026-09-20T16:30:00.000Z",
    "updatedAt": "2026-09-21T09:00:00.000Z",
    "category": {
      "id": "clx1cat001",
      "name": "Comisiones",
      "type": "INGRESO",
      "color": "#10B981",
      "isDefault": true
    },
    "deal": {
      "id": "clx1deal001",
      "title": "Venta Apto Chapinero",
      "status": "OPEN",
      "currency": "COP",
      "value": "350000000.00"
    },
    "contact": {
      "id": "clx1con001",
      "firstName": "María",
      "lastName": "González",
      "phone": "+573001234567",
      "email": "[email protected]"
    },
  …

A chave vai na variável BYDOMU_API_KEY. Os dados do exemplo não são de nenhuma imobiliária.