Contabilidade

Consulte dados contabeis para integracao com sistemas de contabilidade externos. Todos os endpoints deste modulo sao somente leitura.

Integracao Contabil

Estes endpoints permitem que escritorios de contabilidade e sistemas ERP externos consumam os dados contabeis da empresa de forma automatizada.

Contas Contabeis

Listar Contas Contabeis

`GET /external/v1/accounting-accounts`

Retorna uma lista paginada de contas contabeis.

Query Parameters:

Parametro	Tipo	Obrigatorio	Descricao
`page`	`number`	Nao	Pagina atual (default: `1`)
`limit`	`number`	Nao	Itens por pagina (default: `20`, max: `100`)
`accountType`	`string`	Nao	Tipo da conta: `ASSET`, `LIABILITY`, `EQUITY`, `REVENUE`, `EXPENSE`

Exemplo de requisicao:

curl -X GET "https://api.tesselys.com.br/external/v1/accounting-accounts?accountType=ASSET&limit=20" \
  -H "Authorization: Bearer {accessToken}" \
  -H "x-company-token: {companyToken}"

Resposta (200):

{
  "data": [
    {
      "id": "clxacc01a2b3c4d5e6f7g8h9",
      "code": "1.1.01",
      "name": "Caixa Geral",
      "accountType": "ASSET",
      "parentId": "clxacc00r9s8t7u6v5w4x3y2",
      "isAnalytical": true,
      "isActive": true,
      "createdAt": "2026-01-10T08:00:00.000Z"
    },
    {
      "id": "clxacc02b3c4d5e6f7g8h9i0",
      "code": "1.1.02",
      "name": "Bancos Conta Movimento",
      "accountType": "ASSET",
      "parentId": "clxacc00r9s8t7u6v5w4x3y2",
      "isAnalytical": true,
      "isActive": true,
      "createdAt": "2026-01-10T08:00:00.000Z"
    }
  ],
  "meta": {
    "total": 48,
    "page": 1,
    "limit": 20,
    "totalPages": 3
  }
}

Buscar Conta Contabil por ID

`GET /external/v1/accounting-accounts/:id`

Exemplo de requisicao:

curl -X GET "https://api.tesselys.com.br/external/v1/accounting-accounts/clxacc01a2b3c4d5e6f7g8h9" \
  -H "Authorization: Bearer {accessToken}" \
  -H "x-company-token: {companyToken}"

Resposta (200):

{
  "id": "clxacc01a2b3c4d5e6f7g8h9",
  "code": "1.1.01",
  "name": "Caixa Geral",
  "accountType": "ASSET",
  "parentId": "clxacc00r9s8t7u6v5w4x3y2",
  "isAnalytical": true,
  "isActive": true,
  "createdAt": "2026-01-10T08:00:00.000Z"
}

Lancamentos Contabeis

Listar Lancamentos Contabeis

`GET /external/v1/accounting-journal-entries`

Retorna uma lista paginada de lancamentos contabeis.

Query Parameters:

Parametro	Tipo	Obrigatorio	Descricao
`page`	`number`	Nao	Pagina atual (default: `1`)
`limit`	`number`	Nao	Itens por pagina (default: `20`, max: `100`)
`startDate`	`string`	Nao	Data inicial (ISO 8601: `YYYY-MM-DD`)
`endDate`	`string`	Nao	Data final (ISO 8601: `YYYY-MM-DD`)
`status`	`string`	Nao	`DRAFT`, `POSTED`, `REVERSED`

Exemplo de requisicao:

curl -X GET "https://api.tesselys.com.br/external/v1/accounting-journal-entries?status=POSTED&startDate=2026-01-01&endDate=2026-03-31&limit=20" \
  -H "Authorization: Bearer {accessToken}" \
  -H "x-company-token: {companyToken}"

Resposta (200):

{
  "data": [
    {
      "id": "clxje01d4e5f6g7h8i9j0k1l2",
      "code": "LC-0042",
      "description": "Pagamento fornecedor - Servicos de TI",
      "entryDate": "2026-03-15T00:00:00.000Z",
      "status": "POSTED",
      "isAutomatic": false,
      "totalDebit": 3500.00,
      "totalCredit": 3500.00,
      "createdAt": "2026-03-15T14:30:00.000Z"
    },
    {
      "id": "clxje02e5f6g7h8i9j0k1l2m3",
      "code": "LC-0041",
      "description": "Receita de servicos - Consultoria Marco",
      "entryDate": "2026-03-10T00:00:00.000Z",
      "status": "POSTED",
      "isAutomatic": true,
      "totalDebit": 8500.00,
      "totalCredit": 8500.00,
      "createdAt": "2026-03-10T09:00:00.000Z"
    }
  ],
  "meta": {
    "total": 42,
    "page": 1,
    "limit": 20,
    "totalPages": 3
  }
}

Buscar Lancamento Contabil por ID

`GET /external/v1/accounting-journal-entries/:id`

Exemplo de requisicao:

curl -X GET "https://api.tesselys.com.br/external/v1/accounting-journal-entries/clxje01d4e5f6g7h8i9j0k1l2" \
  -H "Authorization: Bearer {accessToken}" \
  -H "x-company-token: {companyToken}"

Resposta (200):

{
  "id": "clxje01d4e5f6g7h8i9j0k1l2",
  "code": "LC-0042",
  "description": "Pagamento fornecedor - Servicos de TI",
  "entryDate": "2026-03-15T00:00:00.000Z",
  "status": "POSTED",
  "isAutomatic": false,
  "totalDebit": 3500.00,
  "totalCredit": 3500.00,
  "createdAt": "2026-03-15T14:30:00.000Z"
}

Partidas de Lancamento Contabil

Listar Partidas

`GET /external/v1/accounting-journal-entry-lines`

Retorna uma lista paginada de partidas (linhas) de lancamentos contabeis.

Query Parameters:

Parametro	Tipo	Obrigatorio	Descricao
`page`	`number`	Nao	Pagina atual (default: `1`)
`limit`	`number`	Nao	Itens por pagina (default: `20`, max: `100`)
`journalEntryId`	`string`	Nao	Filtro por lancamento contabil
`accountingAccountId`	`string`	Nao	Filtro por conta contabil

Exemplo de requisicao:

curl -X GET "https://api.tesselys.com.br/external/v1/accounting-journal-entry-lines?journalEntryId=clxje01d4e5f6g7h8i9j0k1l2&limit=20" \
  -H "Authorization: Bearer {accessToken}" \
  -H "x-company-token: {companyToken}"

Resposta (200):

{
  "data": [
    {
      "id": "clxjl01f6g7h8i9j0k1l2m3n4",
      "journalEntryId": "clxje01d4e5f6g7h8i9j0k1l2",
      "accountingAccountId": "clxacc01a2b3c4d5e6f7g8h9",
      "accountCode": "1.1.01",
      "accountName": "Caixa Geral",
      "type": "CREDIT",
      "amount": 3500.00,
      "description": "Saida de caixa - pagamento fornecedor",
      "createdAt": "2026-03-15T14:30:00.000Z"
    },
    {
      "id": "clxjl02g7h8i9j0k1l2m3n4o5",
      "journalEntryId": "clxje01d4e5f6g7h8i9j0k1l2",
      "accountingAccountId": "clxacc10p1q2r3s4t5u6v7w8",
      "accountCode": "2.1.01",
      "accountName": "Fornecedores",
      "type": "DEBIT",
      "amount": 3500.00,
      "description": "Baixa obrigacao - fornecedor TI",
      "createdAt": "2026-03-15T14:30:00.000Z"
    }
  ],
  "meta": {
    "total": 2,
    "page": 1,
    "limit": 20,
    "totalPages": 1
  }
}

Buscar Partida por ID

`GET /external/v1/accounting-journal-entry-lines/:id`

Exemplo de requisicao:

curl -X GET "https://api.tesselys.com.br/external/v1/accounting-journal-entry-lines/clxjl01f6g7h8i9j0k1l2m3n4" \
  -H "Authorization: Bearer {accessToken}" \
  -H "x-company-token: {companyToken}"

Resposta (200):

{
  "id": "clxjl01f6g7h8i9j0k1l2m3n4",
  "journalEntryId": "clxje01d4e5f6g7h8i9j0k1l2",
  "accountingAccountId": "clxacc01a2b3c4d5e6f7g8h9",
  "accountCode": "1.1.01",
  "accountName": "Caixa Geral",
  "type": "CREDIT",
  "amount": 3500.00,
  "description": "Saida de caixa - pagamento fornecedor",
  "createdAt": "2026-03-15T14:30:00.000Z"
}

Relatorios Contabeis

Endpoints de relatorios computados. Todos somente leitura.

Balancete de Verificacao

`GET /external/v1/accounting-reports/trial-balance`

Retorna o balancete de verificacao para o periodo informado.

Query Parameters:

Parametro	Tipo	Obrigatorio	Descricao
`startDate`	`string`	Sim	Data inicial (ISO 8601: `YYYY-MM-DD`)
`endDate`	`string`	Sim	Data final (ISO 8601: `YYYY-MM-DD`)
`accountId`	`string`	Nao	Filtro por conta contabil especifica

Exemplo de requisicao:

curl -X GET "https://api.tesselys.com.br/external/v1/accounting-reports/trial-balance?startDate=2026-01-01&endDate=2026-12-31" \
  -H "Authorization: Bearer {accessToken}" \
  -H "x-company-token: {companyToken}"

Resposta (200):

{
  "data": [
    {
      "accountId": "clxacc01a2b3c4d5e6f7g8h9",
      "accountCode": "1.1.01",
      "accountName": "Caixa Geral",
      "accountType": "ASSET",
      "previousBalance": 15000.00,
      "totalDebit": 120000.00,
      "totalCredit": 98000.00,
      "finalBalance": 37000.00
    },
    {
      "accountId": "clxacc02b3c4d5e6f7g8h9i0",
      "accountCode": "1.1.02",
      "accountName": "Bancos Conta Movimento",
      "accountType": "ASSET",
      "previousBalance": 45000.00,
      "totalDebit": 250000.00,
      "totalCredit": 230000.00,
      "finalBalance": 65000.00
    },
    {
      "accountId": "clxacc10p1q2r3s4t5u6v7w8",
      "accountCode": "2.1.01",
      "accountName": "Fornecedores",
      "accountType": "LIABILITY",
      "previousBalance": 12000.00,
      "totalDebit": 80000.00,
      "totalCredit": 85000.00,
      "finalBalance": 17000.00
    }
  ]
}

Balanco Patrimonial

`GET /external/v1/accounting-reports/balance-sheet`

Retorna o balanco patrimonial na data de referencia informada.

Query Parameters:

Parametro	Tipo	Obrigatorio	Descricao
`referenceDate`	`string`	Sim	Data de referencia (ISO 8601: `YYYY-MM-DD`)

Exemplo de requisicao:

curl -X GET "https://api.tesselys.com.br/external/v1/accounting-reports/balance-sheet?referenceDate=2026-12-31" \
  -H "Authorization: Bearer {accessToken}" \
  -H "x-company-token: {companyToken}"

Resposta (200):

{
  "assets": [
    {
      "accountId": "clxacc01a2b3c4d5e6f7g8h9",
      "accountCode": "1.1.01",
      "accountName": "Caixa Geral",
      "balance": 37000.00
    },
    {
      "accountId": "clxacc02b3c4d5e6f7g8h9i0",
      "accountCode": "1.1.02",
      "accountName": "Bancos Conta Movimento",
      "balance": 65000.00
    }
  ],
  "liabilities": [
    {
      "accountId": "clxacc10p1q2r3s4t5u6v7w8",
      "accountCode": "2.1.01",
      "accountName": "Fornecedores",
      "balance": 17000.00
    }
  ],
  "equity": [
    {
      "accountId": "clxacc20x1y2z3a4b5c6d7e8",
      "accountCode": "3.1.01",
      "accountName": "Capital Social",
      "balance": 50000.00
    },
    {
      "accountId": "clxacc21y2z3a4b5c6d7e8f9",
      "accountCode": "3.3.01",
      "accountName": "Lucros Acumulados",
      "balance": 35000.00
    }
  ],
  "totalAssets": 102000.00,
  "totalLiabilitiesAndEquity": 102000.00,
  "isBalanced": true
}

Razao Contabil

`GET /external/v1/accounting-reports/general-ledger`

Retorna o razao contabil de uma conta especifica no periodo informado.

Query Parameters:

Parametro	Tipo	Obrigatorio	Descricao
`accountingAccountId`	`string`	Sim	ID da conta contabil
`startDate`	`string`	Sim	Data inicial (ISO 8601: `YYYY-MM-DD`)
`endDate`	`string`	Sim	Data final (ISO 8601: `YYYY-MM-DD`)

Exemplo de requisicao:

curl -X GET "https://api.tesselys.com.br/external/v1/accounting-reports/general-ledger?accountingAccountId=clxacc01a2b3c4d5e6f7g8h9&startDate=2026-01-01&endDate=2026-12-31" \
  -H "Authorization: Bearer {accessToken}" \
  -H "x-company-token: {companyToken}"

Resposta (200):

{
  "account": {
    "id": "clxacc01a2b3c4d5e6f7g8h9",
    "code": "1.1.01",
    "name": "Caixa Geral",
    "accountType": "ASSET"
  },
  "previousBalance": 15000.00,
  "entries": [
    {
      "date": "2026-01-05T00:00:00.000Z",
      "description": "Recebimento cliente - Fatura 2030",
      "debit": 8500.00,
      "credit": 0,
      "runningBalance": 23500.00
    },
    {
      "date": "2026-01-12T00:00:00.000Z",
      "description": "Pagamento aluguel escritorio",
      "debit": 0,
      "credit": 4500.00,
      "runningBalance": 19000.00
    },
    {
      "date": "2026-01-20T00:00:00.000Z",
      "description": "Recebimento cliente - Fatura 2031",
      "debit": 12000.00,
      "credit": 0,
      "runningBalance": 31000.00
    }
  ],
  "finalBalance": 31000.00
}

Extrato de Conta

`GET /external/v1/accounting-reports/account-statement`

Retorna o extrato detalhado de uma conta contabil, incluindo vinculo com lancamentos financeiros.

Query Parameters:

Parametro	Tipo	Obrigatorio	Descricao
`accountingAccountId`	`string`	Sim	ID da conta contabil
`startDate`	`string`	Sim	Data inicial (ISO 8601: `YYYY-MM-DD`)
`endDate`	`string`	Sim	Data final (ISO 8601: `YYYY-MM-DD`)

Exemplo de requisicao:

curl -X GET "https://api.tesselys.com.br/external/v1/accounting-reports/account-statement?accountingAccountId=clxacc01a2b3c4d5e6f7g8h9&startDate=2026-01-01&endDate=2026-12-31" \
  -H "Authorization: Bearer {accessToken}" \
  -H "x-company-token: {companyToken}"

Resposta (200):

{
  "account": {
    "id": "clxacc01a2b3c4d5e6f7g8h9",
    "code": "1.1.01",
    "name": "Caixa Geral",
    "accountType": "ASSET"
  },
  "previousBalance": 15000.00,
  "entries": [
    {
      "date": "2026-01-05T00:00:00.000Z",
      "description": "Recebimento cliente - Fatura 2030",
      "debit": 8500.00,
      "credit": 0,
      "runningBalance": 23500.00,
      "financialEntryId": "clx5e6f7g8h9i0j1k2l3m4n5"
    },
    {
      "date": "2026-01-12T00:00:00.000Z",
      "description": "Pagamento aluguel escritorio",
      "debit": 0,
      "credit": 4500.00,
      "runningBalance": 19000.00,
      "financialEntryId": "clx7h8i9j0k1l2m3n4o5p6q7"
    }
  ],
  "finalBalance": 19000.00
}

Dashboard Contabil

`GET /external/v1/accounting-reports/dashboard-summary`

Retorna um resumo consolidado dos dados contabeis para dashboards.

Query Parameters:

Parametro	Tipo	Obrigatorio	Descricao
`startDate`	`string`	Sim	Data inicial (ISO 8601: `YYYY-MM-DD`)
`endDate`	`string`	Sim	Data final (ISO 8601: `YYYY-MM-DD`)

Exemplo de requisicao:

curl -X GET "https://api.tesselys.com.br/external/v1/accounting-reports/dashboard-summary?startDate=2026-01-01&endDate=2026-06-30" \
  -H "Authorization: Bearer {accessToken}" \
  -H "x-company-token: {companyToken}"

Resposta (200):

{
  "cards": {
    "totalAccounts": 48,
    "totalEntries": 156,
    "totalDebit": 580000.00,
    "totalCredit": 580000.00
  },
  "monthlyMovement": [
    {
      "month": "2026-01",
      "totalDebit": 95000.00,
      "totalCredit": 95000.00
    },
    {
      "month": "2026-02",
      "totalDebit": 102000.00,
      "totalCredit": 102000.00
    },
    {
      "month": "2026-03",
      "totalDebit": 98000.00,
      "totalCredit": 98000.00
    },
    {
      "month": "2026-04",
      "totalDebit": 110000.00,
      "totalCredit": 110000.00
    },
    {
      "month": "2026-05",
      "totalDebit": 88000.00,
      "totalCredit": 88000.00
    },
    {
      "month": "2026-06",
      "totalDebit": 87000.00,
      "totalCredit": 87000.00
    }
  ],
  "balanceComposition": {
    "totalAssets": 102000.00,
    "totalLiabilities": 17000.00,
    "totalEquity": 85000.00
  },
  "recentEntries": [
    {
      "id": "clxje01d4e5f6g7h8i9j0k1l2",
      "code": "LC-0042",
      "description": "Pagamento fornecedor - Servicos de TI",
      "entryDate": "2026-03-15T00:00:00.000Z",
      "totalDebit": 3500.00,
      "totalCredit": 3500.00
    },
    {
      "id": "clxje02e5f6g7h8i9j0k1l2m3",
      "code": "LC-0041",
      "description": "Receita de servicos - Consultoria Marco",
      "entryDate": "2026-03-10T00:00:00.000Z",
      "totalDebit": 8500.00,
      "totalCredit": 8500.00
    }
  ]
}

Valores de Enum

accountType

Valor	Descricao
`ASSET`	Ativo
`LIABILITY`	Passivo
`EQUITY`	Patrimonio liquido
`REVENUE`	Receita
`EXPENSE`	Despesa

status (lancamento contabil)

Valor	Descricao
`DRAFT`	Rascunho — lancamento ainda nao efetivado
`POSTED`	Efetivado — lancamento contabilizado
`REVERSED`	Estornado — lancamento revertido

type (partida)

Valor	Descricao
`DEBIT`	Debito
`CREDIT`	Credito

Contas Contabeis​

Listar Contas Contabeis​

GET /external/v1/accounting-accounts​

Buscar Conta Contabil por ID​

GET /external/v1/accounting-accounts/:id​

Lancamentos Contabeis​

Listar Lancamentos Contabeis​

GET /external/v1/accounting-journal-entries​

Buscar Lancamento Contabil por ID​

GET /external/v1/accounting-journal-entries/:id​

Partidas de Lancamento Contabil​

Listar Partidas​

GET /external/v1/accounting-journal-entry-lines​

Buscar Partida por ID​

GET /external/v1/accounting-journal-entry-lines/:id​

Relatorios Contabeis​

Balancete de Verificacao​

GET /external/v1/accounting-reports/trial-balance​

Balanco Patrimonial​

GET /external/v1/accounting-reports/balance-sheet​

Razao Contabil​

GET /external/v1/accounting-reports/general-ledger​

Extrato de Conta​

GET /external/v1/accounting-reports/account-statement​

Dashboard Contabil​

GET /external/v1/accounting-reports/dashboard-summary​

Valores de Enum​

accountType​

status (lancamento contabil)​

type (partida)​

Contas Contabeis

Listar Contas Contabeis

`GET /external/v1/accounting-accounts`

Buscar Conta Contabil por ID

`GET /external/v1/accounting-accounts/:id`

Lancamentos Contabeis

Listar Lancamentos Contabeis

`GET /external/v1/accounting-journal-entries`

Buscar Lancamento Contabil por ID

`GET /external/v1/accounting-journal-entries/:id`

Partidas de Lancamento Contabil

Listar Partidas

`GET /external/v1/accounting-journal-entry-lines`

Buscar Partida por ID

`GET /external/v1/accounting-journal-entry-lines/:id`

Relatorios Contabeis

Balancete de Verificacao

`GET /external/v1/accounting-reports/trial-balance`

Balanco Patrimonial

`GET /external/v1/accounting-reports/balance-sheet`

Razao Contabil

`GET /external/v1/accounting-reports/general-ledger`

Extrato de Conta

`GET /external/v1/accounting-reports/account-statement`

Dashboard Contabil

`GET /external/v1/accounting-reports/dashboard-summary`

Valores de Enum

accountType

status (lancamento contabil)

type (partida)