Financeiro

Gerencie lancamentos financeiros, categorias, contas bancarias, medicoes, notas fiscais, cobrancas e provisionamento.

Lancamentos Financeiros

Listar Lancamentos

`GET /external/v1/financial-entries`

Retorna uma lista paginada de lancamentos financeiros.

Query Parameters:

Parametro	Tipo	Obrigatorio	Descricao
`page`	`number`	Nao	Pagina atual (default: `1`)
`limit`	`number`	Nao	Itens por pagina (default: `20`, max: `100`)
`search`	`string`	Nao	Busca por titulo
`typeCategory`	`string`	Nao	`REVENUE` (receita) ou `EXPENSE` (despesa)
`status`	`string`	Nao	`PENDING`, `SETTLED`, `OVERDUE`, `CANCELLED`
`personId`	`string`	Nao	Filtro por pessoa vinculada
`dueDateFrom`	`string`	Nao	Vencimento a partir de (ISO 8601: `YYYY-MM-DD`)
`dueDateTo`	`string`	Nao	Vencimento ate (ISO 8601: `YYYY-MM-DD`)
`orderBy`	`string`	Nao	Campo: `title`, `originalDueDate`, `originalAmount`, `createdAt` (default: `createdAt`)
`order`	`string`	Nao	`ASC` ou `DESC` (default: `DESC`)

Exemplo de requisicao:

curl -X GET "https://api.tesselys.com.br/external/v1/financial-entries?typeCategory=REVENUE&status=PENDING&dueDateFrom=2026-03-01&dueDateTo=2026-03-31&limit=20" \
  -H "Authorization: Bearer {accessToken}" \
  -H "x-company-token: {companyToken}"

Resposta (200):

{
  "data": [
    {
      "id": "clx5e6f7g8h9i0j1k2l3m4n5",
      "code": "REC-2030",
      "title": "Fatura Mensal - Tech Solutions",
      "personId": "clx1a2b3c4d5e6f7g8h9i0j1",
      "personName": "Tech Solutions Ltda",
      "typeCategory": "REVENUE",
      "status": "PENDING",
      "originalAmount": 8500.00,
      "paidAmount": null,
      "originalDueDate": "2026-03-31T00:00:00.000Z",
      "paymentDate": null,
      "financialCategoryId": "clxcat001",
      "financialCategoryName": "Servicos Prestados",
      "bankAccountId": "clxbank001",
      "bankAccountName": "Conta Principal - Itau",
      "paymentMethod": "BANK_SLIP",
      "installmentNumber": 1,
      "totalInstallments": 1,
      "isActive": true,
      "createdAt": "2026-03-01T09:00:00.000Z",
      "updatedAt": "2026-03-01T09:00:00.000Z"
    }
  ],
  "meta": {
    "total": 34,
    "page": 1,
    "limit": 20,
    "totalPages": 2
  }
}

Buscar Lancamento por ID

`GET /external/v1/financial-entries/:id`

Exemplo de requisicao:

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

Resposta (200):

{
  "id": "clx5e6f7g8h9i0j1k2l3m4n5",
  "code": "REC-2030",
  "title": "Fatura Mensal - Tech Solutions",
  "personId": "clx1a2b3c4d5e6f7g8h9i0j1",
  "personName": "Tech Solutions Ltda",
  "typeCategory": "REVENUE",
  "status": "PENDING",
  "originalAmount": 8500.00,
  "paidAmount": null,
  "discountAmount": 0,
  "interestAmount": 0,
  "fineAmount": 0,
  "originalDueDate": "2026-03-31T00:00:00.000Z",
  "paymentDate": null,
  "financialCategoryId": "clxcat001",
  "financialCategoryName": "Servicos Prestados",
  "bankAccountId": "clxbank001",
  "bankAccountName": "Conta Principal - Itau",
  "paymentMethod": "BANK_SLIP",
  "installmentNumber": 1,
  "totalInstallments": 1,
  "notes": "Referente ao contrato mensal de suporte tecnico.",
  "isActive": true,
  "createdAt": "2026-03-01T09:00:00.000Z",
  "updatedAt": "2026-03-01T09:00:00.000Z"
}

Criar Lancamento

`POST /external/v1/financial-entries`

Body:

Campo	Tipo	Obrigatorio	Descricao
`personId`	`string`	Sim	ID da pessoa vinculada
`title`	`string`	Sim	Titulo do lancamento (max: 255)
`typeCategory`	`string`	Sim	`REVENUE` (receita) ou `EXPENSE` (despesa)
`originalAmount`	`number`	Sim	Valor original (deve ser maior que zero)
`originalDueDate`	`string`	Sim	Data de vencimento (ISO 8601: `YYYY-MM-DD`)
`financialCategoryId`	`string`	Sim	ID da categoria financeira
`bankAccountId`	`string`	Sim	ID da conta bancaria
`paymentMethod`	`string`	Nao	Metodo de pagamento (ver enum abaixo)
`totalInstallments`	`number`	Nao	Numero de parcelas (default: `1`, max: `120`)
`notes`	`string`	Nao	Observacoes

Exemplo — Lancamento avista:

curl -X POST "https://api.tesselys.com.br/external/v1/financial-entries" \
  -H "Authorization: Bearer {accessToken}" \
  -H "x-company-token: {companyToken}" \
  -H "Content-Type: application/json" \
  -d '{
    "personId": "clx1a2b3c4d5e6f7g8h9i0j1",
    "title": "Consultoria Tributaria - Marco/2026",
    "typeCategory": "REVENUE",
    "originalAmount": 4500.00,
    "originalDueDate": "2026-04-10",
    "financialCategoryId": "clxcat001",
    "bankAccountId": "clxbank001",
    "paymentMethod": "PIX"
  }'

Resposta (201):

{
  "id": "clx6f7g8h9i0j1k2l3m4n5o6",
  "code": "REC-2031",
  "title": "Consultoria Tributaria - Marco/2026",
  "personId": "clx1a2b3c4d5e6f7g8h9i0j1",
  "personName": "Tech Solutions Ltda",
  "typeCategory": "REVENUE",
  "status": "PENDING",
  "originalAmount": 4500.00,
  "paidAmount": null,
  "originalDueDate": "2026-04-10T00:00:00.000Z",
  "paymentDate": null,
  "financialCategoryId": "clxcat001",
  "financialCategoryName": "Servicos Prestados",
  "bankAccountId": "clxbank001",
  "bankAccountName": "Conta Principal - Itau",
  "paymentMethod": "PIX",
  "installmentNumber": 1,
  "totalInstallments": 1,
  "isActive": true,
  "createdAt": "2026-03-25T10:30:00.000Z",
  "updatedAt": "2026-03-25T10:30:00.000Z"
}

Exemplo — Lancamento parcelado:

curl -X POST "https://api.tesselys.com.br/external/v1/financial-entries" \
  -H "Authorization: Bearer {accessToken}" \
  -H "x-company-token: {companyToken}" \
  -H "Content-Type: application/json" \
  -d '{
    "personId": "clx1a2b3c4d5e6f7g8h9i0j1",
    "title": "Licenca Anual de Software",
    "typeCategory": "EXPENSE",
    "originalAmount": 24000.00,
    "originalDueDate": "2026-04-01",
    "financialCategoryId": "clxcat005",
    "bankAccountId": "clxbank001",
    "paymentMethod": "CREDIT_CARD",
    "totalInstallments": 12,
    "notes": "Licenca anual do software de gestao. 12x de R$ 2.000,00."
  }'

Parcelamento

Quando totalInstallments > 1, o sistema cria automaticamente as parcelas com vencimentos mensais a partir da originalDueDate. O valor de cada parcela e calculado automaticamente (originalAmount / totalInstallments).

Categorias Financeiras

Somente leitura

Categorias financeiras sao gerenciadas pelo painel da Tesselys. A API Externa permite apenas consulta.

Listar Categorias

`GET /external/v1/financial-categories`

Retorna uma lista paginada de categorias financeiras.

Query Parameters:

Parametro	Tipo	Obrigatorio	Descricao
`page`	`number`	Nao	Pagina atual (default: `1`)
`limit`	`number`	Nao	Itens por pagina (default: `20`, max: `100`)
`type`	`string`	Nao	`REVENUE` (receita) ou `EXPENSE` (despesa)

Exemplo de requisicao:

curl -X GET "https://api.tesselys.com.br/external/v1/financial-categories?type=REVENUE&limit=20" \
  -H "Authorization: Bearer {accessToken}" \
  -H "x-company-token: {companyToken}"

Resposta (200):

{
  "data": [
    {
      "id": "clxcat001a2b3c4d5e6f7g8h9",
      "name": "Servicos Prestados",
      "type": "REVENUE",
      "parentId": null,
      "code": "1.01",
      "isActive": true
    },
    {
      "id": "clxcat002b3c4d5e6f7g8h9i0",
      "name": "Consultoria",
      "type": "REVENUE",
      "parentId": "clxcat001a2b3c4d5e6f7g8h9",
      "code": "1.01.01",
      "isActive": true
    }
  ],
  "meta": {
    "total": 18,
    "page": 1,
    "limit": 20,
    "totalPages": 1
  }
}

Buscar Categoria por ID

`GET /external/v1/financial-categories/:id`

Exemplo de requisicao:

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

Resposta (200):

{
  "id": "clxcat001a2b3c4d5e6f7g8h9",
  "name": "Servicos Prestados",
  "type": "REVENUE",
  "parentId": null,
  "code": "1.01",
  "isActive": true
}

Contas Bancarias

Somente leitura

Contas bancarias sao gerenciadas pelo painel da Tesselys. A API Externa permite apenas consulta.

Listar Contas Bancarias

`GET /external/v1/bank-accounts`

Retorna uma lista paginada de contas bancarias.

Query Parameters:

Parametro	Tipo	Obrigatorio	Descricao
`page`	`number`	Nao	Pagina atual (default: `1`)
`limit`	`number`	Nao	Itens por pagina (default: `20`, max: `100`)

Exemplo de requisicao:

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

Resposta (200):

{
  "data": [
    {
      "id": "clxbank01a2b3c4d5e6f7g8h9",
      "bankName": "Itau Unibanco",
      "agency": "1234",
      "accountNumber": "56789-0",
      "accountType": "CHECKING",
      "balance": 45320.50,
      "isActive": true
    },
    {
      "id": "clxbank02b3c4d5e6f7g8h9i0",
      "bankName": "Banco do Brasil",
      "agency": "5678",
      "accountNumber": "12345-6",
      "accountType": "SAVINGS",
      "balance": 12000.00,
      "isActive": true
    }
  ],
  "meta": {
    "total": 3,
    "page": 1,
    "limit": 20,
    "totalPages": 1
  }
}

Buscar Conta Bancaria por ID

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

Exemplo de requisicao:

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

Resposta (200):

{
  "id": "clxbank01a2b3c4d5e6f7g8h9",
  "bankName": "Itau Unibanco",
  "agency": "1234",
  "accountNumber": "56789-0",
  "accountType": "CHECKING",
  "balance": 45320.50,
  "isActive": true
}

Medicoes (Measurements)

Listar Medicoes

`GET /external/v1/measurements`

Retorna uma lista paginada de medicoes.

Query Parameters:

Parametro	Tipo	Obrigatorio	Descricao
`page`	`number`	Nao	Pagina atual (default: `1`)
`limit`	`number`	Nao	Itens por pagina (default: `20`, max: `100`)
`status`	`string`	Nao	`DRAFT`, `SUBMITTED`, `APPROVED`, `REJECTED`
`personId`	`string`	Nao	Filtro por pessoa vinculada

Exemplo de requisicao:

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

Resposta (200):

{
  "data": [
    {
      "id": "clxmsr01a2b3c4d5e6f7g8h9",
      "title": "Medicao Marco/2026 - Projeto Alpha",
      "personId": "clx1a2b3c4d5e6f7g8h9i0j1",
      "personName": "Tech Solutions Ltda",
      "measurementType": "DETAILED",
      "status": "APPROVED",
      "totalAmount": 32500.00,
      "startDate": "2026-03-01T00:00:00.000Z",
      "endDate": "2026-03-31T00:00:00.000Z",
      "createdAt": "2026-03-25T14:00:00.000Z"
    }
  ],
  "meta": {
    "total": 12,
    "page": 1,
    "limit": 20,
    "totalPages": 1
  }
}

Buscar Medicao por ID

`GET /external/v1/measurements/:id`

Exemplo de requisicao:

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

Resposta (200):

{
  "id": "clxmsr01a2b3c4d5e6f7g8h9",
  "title": "Medicao Marco/2026 - Projeto Alpha",
  "personId": "clx1a2b3c4d5e6f7g8h9i0j1",
  "personName": "Tech Solutions Ltda",
  "measurementType": "DETAILED",
  "status": "APPROVED",
  "totalAmount": 32500.00,
  "startDate": "2026-03-01T00:00:00.000Z",
  "endDate": "2026-03-31T00:00:00.000Z",
  "createdAt": "2026-03-25T14:00:00.000Z"
}

Criar Medicao

`POST /external/v1/measurements`

Body:

Campo	Tipo	Obrigatorio	Descricao
`title`	`string`	Sim	Titulo da medicao (max: 255)
`personId`	`string`	Sim	ID da pessoa vinculada
`measurementType`	`string`	Nao	`SIMPLE` ou `DETAILED` (default: `SIMPLE`)
`startDate`	`string`	Nao	Data de inicio (ISO 8601: `YYYY-MM-DD`)
`endDate`	`string`	Nao	Data de fim (ISO 8601: `YYYY-MM-DD`)

Exemplo de requisicao:

curl -X POST "https://api.tesselys.com.br/external/v1/measurements" \
  -H "Authorization: Bearer {accessToken}" \
  -H "x-company-token: {companyToken}" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Medicao Abril/2026 - Projeto Beta",
    "personId": "clx1a2b3c4d5e6f7g8h9i0j1",
    "measurementType": "SIMPLE",
    "startDate": "2026-04-01",
    "endDate": "2026-04-30"
  }'

Resposta (201):

{
  "id": "clxmsr02b3c4d5e6f7g8h9i0",
  "title": "Medicao Abril/2026 - Projeto Beta",
  "personId": "clx1a2b3c4d5e6f7g8h9i0j1",
  "personName": "Tech Solutions Ltda",
  "measurementType": "SIMPLE",
  "status": "DRAFT",
  "totalAmount": 0,
  "startDate": "2026-04-01T00:00:00.000Z",
  "endDate": "2026-04-30T00:00:00.000Z",
  "createdAt": "2026-03-26T10:00:00.000Z"
}

Notas Fiscais (Invoices)

Listar Notas Fiscais

`GET /external/v1/invoices`

Retorna uma lista paginada de notas fiscais.

Query Parameters:

Parametro	Tipo	Obrigatorio	Descricao
`page`	`number`	Nao	Pagina atual (default: `1`)
`limit`	`number`	Nao	Itens por pagina (default: `20`, max: `100`)
`status`	`string`	Nao	`DRAFT`, `SENT`, `PAID`, `CANCELLED`
`personId`	`string`	Nao	Filtro por pessoa vinculada

Exemplo de requisicao:

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

Resposta (200):

{
  "data": [
    {
      "id": "clxinv01a2b3c4d5e6f7g8h9",
      "personId": "clx1a2b3c4d5e6f7g8h9i0j1",
      "personName": "Tech Solutions Ltda",
      "measurementId": "clxmsr01a2b3c4d5e6f7g8h9",
      "invoiceAmount": 32500.00,
      "status": "SENT",
      "dueDate": "2026-04-15T00:00:00.000Z",
      "createdAt": "2026-03-26T11:00:00.000Z"
    }
  ],
  "meta": {
    "total": 8,
    "page": 1,
    "limit": 20,
    "totalPages": 1
  }
}

Buscar Nota Fiscal por ID

`GET /external/v1/invoices/:id`

Exemplo de requisicao:

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

Resposta (200):

{
  "id": "clxinv01a2b3c4d5e6f7g8h9",
  "personId": "clx1a2b3c4d5e6f7g8h9i0j1",
  "personName": "Tech Solutions Ltda",
  "measurementId": "clxmsr01a2b3c4d5e6f7g8h9",
  "invoiceAmount": 32500.00,
  "status": "SENT",
  "dueDate": "2026-04-15T00:00:00.000Z",
  "createdAt": "2026-03-26T11:00:00.000Z"
}

Criar Nota Fiscal

`POST /external/v1/invoices`

Body:

Campo	Tipo	Obrigatorio	Descricao
`personId`	`string`	Sim	ID da pessoa vinculada
`measurementId`	`string`	Nao	ID da medicao associada
`invoiceAmount`	`number`	Sim	Valor da nota fiscal (deve ser maior que zero)
`dueDate`	`string`	Nao	Data de vencimento (ISO 8601: `YYYY-MM-DD`)
`description`	`string`	Nao	Descricao da nota fiscal

Exemplo de requisicao:

curl -X POST "https://api.tesselys.com.br/external/v1/invoices" \
  -H "Authorization: Bearer {accessToken}" \
  -H "x-company-token: {companyToken}" \
  -H "Content-Type: application/json" \
  -d '{
    "personId": "clx1a2b3c4d5e6f7g8h9i0j1",
    "measurementId": "clxmsr01a2b3c4d5e6f7g8h9",
    "invoiceAmount": 32500.00,
    "dueDate": "2026-04-15",
    "description": "NF referente a medicao de marco/2026"
  }'

Resposta (201):

{
  "id": "clxinv02b3c4d5e6f7g8h9i0",
  "personId": "clx1a2b3c4d5e6f7g8h9i0j1",
  "personName": "Tech Solutions Ltda",
  "measurementId": "clxmsr01a2b3c4d5e6f7g8h9",
  "invoiceAmount": 32500.00,
  "status": "DRAFT",
  "dueDate": "2026-04-15T00:00:00.000Z",
  "createdAt": "2026-03-26T11:30:00.000Z"
}

Cobrancas (Charges)

Somente leitura

Cobrancas sao geradas automaticamente pelo sistema de faturamento. A API Externa permite apenas consulta.

Listar Cobrancas

`GET /external/v1/charges`

Retorna uma lista paginada de cobrancas.

Query Parameters:

Parametro	Tipo	Obrigatorio	Descricao
`page`	`number`	Nao	Pagina atual (default: `1`)
`limit`	`number`	Nao	Itens por pagina (default: `20`, max: `100`)
`status`	`string`	Nao	`PENDING`, `CONFIRMED`, `RECEIVED`, `OVERDUE`, `REFUNDED`, `CANCELLED`
`personId`	`string`	Nao	Filtro por pessoa vinculada

Exemplo de requisicao:

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

Resposta (200):

{
  "data": [
    {
      "id": "clxchg01a2b3c4d5e6f7g8h9",
      "financialEntryId": "clx5e6f7g8h9i0j1k2l3m4n5",
      "personId": "clx1a2b3c4d5e6f7g8h9i0j1",
      "personName": "Tech Solutions Ltda",
      "amount": 8500.00,
      "status": "PENDING",
      "dueDate": "2026-04-10T00:00:00.000Z",
      "paidAt": null,
      "paymentMethod": "PIX",
      "createdAt": "2026-03-26T09:00:00.000Z"
    }
  ],
  "meta": {
    "total": 5,
    "page": 1,
    "limit": 20,
    "totalPages": 1
  }
}

Buscar Cobranca por ID

`GET /external/v1/charges/:id`

Exemplo de requisicao:

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

Resposta (200):

{
  "id": "clxchg01a2b3c4d5e6f7g8h9",
  "financialEntryId": "clx5e6f7g8h9i0j1k2l3m4n5",
  "personId": "clx1a2b3c4d5e6f7g8h9i0j1",
  "personName": "Tech Solutions Ltda",
  "amount": 8500.00,
  "status": "PENDING",
  "dueDate": "2026-04-10T00:00:00.000Z",
  "paidAt": null,
  "paymentMethod": "PIX",
  "createdAt": "2026-03-26T09:00:00.000Z"
}

Provisionamento

Listar Provisionamentos

`GET /external/v1/provisioning`

Retorna uma lista paginada de provisionamentos financeiros.

Query Parameters:

Parametro	Tipo	Obrigatorio	Descricao
`page`	`number`	Nao	Pagina atual (default: `1`)
`limit`	`number`	Nao	Itens por pagina (default: `20`, max: `100`)
`typeCategory`	`string`	Nao	`REVENUE` (receita) ou `EXPENSE` (despesa)

Exemplo de requisicao:

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

Resposta (200):

{
  "data": [
    {
      "id": "clxprv01a2b3c4d5e6f7g8h9",
      "title": "Aluguel Escritorio Central",
      "amount": 6500.00,
      "typeCategory": "EXPENSE",
      "repeatPeriod": "MONTHLY",
      "startDate": "2026-01-01T00:00:00.000Z",
      "endDate": null,
      "bankAccountId": "clxbank01a2b3c4d5e6f7g8h9",
      "financialCategoryId": "clxcat003c4d5e6f7g8h9i0j1",
      "personId": "clx2b3c4d5e6f7g8h9i0j1k2",
      "costCenterId": "clxcc001a2b3c4d5e6f7g8h9",
      "isActive": true,
      "createdAt": "2026-01-05T08:00:00.000Z"
    }
  ],
  "meta": {
    "total": 7,
    "page": 1,
    "limit": 20,
    "totalPages": 1
  }
}

Buscar Provisionamento por ID

`GET /external/v1/provisioning/:id`

Exemplo de requisicao:

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

Resposta (200):

{
  "id": "clxprv01a2b3c4d5e6f7g8h9",
  "title": "Aluguel Escritorio Central",
  "amount": 6500.00,
  "typeCategory": "EXPENSE",
  "repeatPeriod": "MONTHLY",
  "startDate": "2026-01-01T00:00:00.000Z",
  "endDate": null,
  "bankAccountId": "clxbank01a2b3c4d5e6f7g8h9",
  "financialCategoryId": "clxcat003c4d5e6f7g8h9i0j1",
  "personId": "clx2b3c4d5e6f7g8h9i0j1k2",
  "costCenterId": "clxcc001a2b3c4d5e6f7g8h9",
  "isActive": true,
  "createdAt": "2026-01-05T08:00:00.000Z"
}

Criar Provisionamento

`POST /external/v1/provisioning`

Body:

Campo	Tipo	Obrigatorio	Descricao
`title`	`string`	Sim	Titulo do provisionamento (max: 255)
`amount`	`number`	Sim	Valor provisionado (deve ser maior que zero)
`typeCategory`	`string`	Sim	`REVENUE` (receita) ou `EXPENSE` (despesa)
`startDate`	`string`	Sim	Data de inicio (ISO 8601: `YYYY-MM-DD`)
`repeatPeriod`	`string`	Nao	`MONTHLY`, `WEEKLY` ou `BIWEEKLY`
`bankAccountId`	`string`	Nao	ID da conta bancaria
`financialCategoryId`	`string`	Nao	ID da categoria financeira
`costCenterId`	`string`	Nao	ID do centro de custo
`personId`	`string`	Nao	ID da pessoa vinculada

Exemplo de requisicao:

curl -X POST "https://api.tesselys.com.br/external/v1/provisioning" \
  -H "Authorization: Bearer {accessToken}" \
  -H "x-company-token: {companyToken}" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Manutencao Mensal - Servidores",
    "amount": 3200.00,
    "typeCategory": "EXPENSE",
    "startDate": "2026-04-01",
    "repeatPeriod": "MONTHLY",
    "bankAccountId": "clxbank01a2b3c4d5e6f7g8h9",
    "financialCategoryId": "clxcat003c4d5e6f7g8h9i0j1",
    "costCenterId": "clxcc001a2b3c4d5e6f7g8h9"
  }'

Resposta (201):

{
  "id": "clxprv02b3c4d5e6f7g8h9i0",
  "title": "Manutencao Mensal - Servidores",
  "amount": 3200.00,
  "typeCategory": "EXPENSE",
  "repeatPeriod": "MONTHLY",
  "startDate": "2026-04-01T00:00:00.000Z",
  "endDate": null,
  "bankAccountId": "clxbank01a2b3c4d5e6f7g8h9",
  "financialCategoryId": "clxcat003c4d5e6f7g8h9i0j1",
  "personId": null,
  "costCenterId": "clxcc001a2b3c4d5e6f7g8h9",
  "isActive": true,
  "createdAt": "2026-03-26T12:00:00.000Z"
}

Atualizar Provisionamento

`PUT /external/v1/provisioning/:id`

Aceita os mesmos campos do POST (todos opcionais na atualizacao).

Exemplo de requisicao:

curl -X PUT "https://api.tesselys.com.br/external/v1/provisioning/clxprv02b3c4d5e6f7g8h9i0" \
  -H "Authorization: Bearer {accessToken}" \
  -H "x-company-token: {companyToken}" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 3500.00,
    "personId": "clx2b3c4d5e6f7g8h9i0j1k2"
  }'

Resposta (200):

{
  "id": "clxprv02b3c4d5e6f7g8h9i0",
  "title": "Manutencao Mensal - Servidores",
  "amount": 3500.00,
  "typeCategory": "EXPENSE",
  "repeatPeriod": "MONTHLY",
  "startDate": "2026-04-01T00:00:00.000Z",
  "endDate": null,
  "bankAccountId": "clxbank01a2b3c4d5e6f7g8h9",
  "financialCategoryId": "clxcat003c4d5e6f7g8h9i0j1",
  "personId": "clx2b3c4d5e6f7g8h9i0j1k2",
  "costCenterId": "clxcc001a2b3c4d5e6f7g8h9",
  "isActive": true,
  "createdAt": "2026-03-26T12:00:00.000Z"
}

Valores de Enum

typeCategory

Valor	Descricao
`REVENUE`	Receita (conta a receber)
`EXPENSE`	Despesa (conta a pagar)

status — Lancamentos (somente leitura)

Valor	Descricao
`PENDING`	Pendente — aguardando pagamento
`SETTLED`	Liquidado — pagamento confirmado
`OVERDUE`	Vencido — passou da data de vencimento sem pagamento
`CANCELLED`	Cancelado

paymentMethod

Valor	Descricao
`PIX`	PIX
`CREDIT_CARD`	Cartao de credito
`DEBIT_CARD`	Cartao de debito
`BANK_SLIP`	Boleto bancario
`BANK_TRANSFER`	Transferencia bancaria
`CASH`	Dinheiro
`CHECK`	Cheque
`OTHER`	Outro

accountType (Contas Bancarias)

Valor	Descricao
`CHECKING`	Conta corrente
`SAVINGS`	Conta poupanca

measurementType (Medicoes)

Valor	Descricao
`SIMPLE`	Medicao simples
`DETAILED`	Medicao detalhada

status — Medicoes

Valor	Descricao
`DRAFT`	Rascunho — em elaboracao
`SUBMITTED`	Submetida — aguardando aprovacao
`APPROVED`	Aprovada
`REJECTED`	Rejeitada

status — Notas Fiscais

Valor	Descricao
`DRAFT`	Rascunho — em elaboracao
`SENT`	Enviada ao cliente
`PAID`	Paga
`CANCELLED`	Cancelada

status — Cobrancas

Valor	Descricao
`PENDING`	Pendente — aguardando pagamento
`CONFIRMED`	Confirmada — pagamento identificado
`RECEIVED`	Recebida — pagamento creditado
`OVERDUE`	Vencida — passou da data de vencimento
`REFUNDED`	Estornada
`CANCELLED`	Cancelada

repeatPeriod (Provisionamento)

Valor	Descricao
`MONTHLY`	Mensal
`WEEKLY`	Semanal
`BIWEEKLY`	Quinzenal

Lancamentos Financeiros​

Listar Lancamentos​

GET /external/v1/financial-entries​

Buscar Lancamento por ID​

GET /external/v1/financial-entries/:id​

Criar Lancamento​

POST /external/v1/financial-entries​

Categorias Financeiras​

Listar Categorias​

GET /external/v1/financial-categories​

Buscar Categoria por ID​

GET /external/v1/financial-categories/:id​

Contas Bancarias​

Listar Contas Bancarias​

GET /external/v1/bank-accounts​

Buscar Conta Bancaria por ID​

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

Medicoes (Measurements)​

Listar Medicoes​

GET /external/v1/measurements​

Buscar Medicao por ID​

GET /external/v1/measurements/:id​

Criar Medicao​

POST /external/v1/measurements​

Notas Fiscais (Invoices)​

Listar Notas Fiscais​

GET /external/v1/invoices​

Buscar Nota Fiscal por ID​

GET /external/v1/invoices/:id​

Criar Nota Fiscal​

POST /external/v1/invoices​

Cobrancas (Charges)​

Listar Cobrancas​

GET /external/v1/charges​

Buscar Cobranca por ID​

GET /external/v1/charges/:id​

Provisionamento​

Listar Provisionamentos​

GET /external/v1/provisioning​

Buscar Provisionamento por ID​

GET /external/v1/provisioning/:id​

Criar Provisionamento​

POST /external/v1/provisioning​

Atualizar Provisionamento​

PUT /external/v1/provisioning/:id​

Valores de Enum​

typeCategory​

status — Lancamentos (somente leitura)​

paymentMethod​

accountType (Contas Bancarias)​

measurementType (Medicoes)​

status — Medicoes​

status — Notas Fiscais​

status — Cobrancas​

repeatPeriod (Provisionamento)​

Lancamentos Financeiros

Listar Lancamentos

`GET /external/v1/financial-entries`

Buscar Lancamento por ID

`GET /external/v1/financial-entries/:id`

Criar Lancamento

`POST /external/v1/financial-entries`

Categorias Financeiras

Listar Categorias

`GET /external/v1/financial-categories`

Buscar Categoria por ID

`GET /external/v1/financial-categories/:id`

Contas Bancarias

Listar Contas Bancarias

`GET /external/v1/bank-accounts`

Buscar Conta Bancaria por ID

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

Medicoes (Measurements)

Listar Medicoes

`GET /external/v1/measurements`

Buscar Medicao por ID

`GET /external/v1/measurements/:id`

Criar Medicao

`POST /external/v1/measurements`

Notas Fiscais (Invoices)

Listar Notas Fiscais

`GET /external/v1/invoices`

Buscar Nota Fiscal por ID

`GET /external/v1/invoices/:id`

Criar Nota Fiscal

`POST /external/v1/invoices`

Cobrancas (Charges)

Listar Cobrancas

`GET /external/v1/charges`

Buscar Cobranca por ID

`GET /external/v1/charges/:id`

Provisionamento

Listar Provisionamentos

`GET /external/v1/provisioning`

Buscar Provisionamento por ID

`GET /external/v1/provisioning/:id`

Criar Provisionamento

`POST /external/v1/provisioning`

Atualizar Provisionamento

`PUT /external/v1/provisioning/:id`

Valores de Enum

typeCategory

status — Lancamentos (somente leitura)

paymentMethod

accountType (Contas Bancarias)

measurementType (Medicoes)

status — Medicoes

status — Notas Fiscais

status — Cobrancas

repeatPeriod (Provisionamento)