v1

latestOpenAPI 3.0.3Licença Sankhya2026-07-24161242654.8 KB

Financeiros Movimentos

Registrar Receitas

Registra financeiro de receita

post/v1/financeiros/receitas

Request body

codigoEmpresainteger required

Insira o código da Empresa para realizar a inclusão do Financeiro. Esse código é facilmente acessível através da nossa API, na entidade "Empresa" (CODEMP). Obtenha essa informação e mantenha seus registros sempre atualizados. Para saber mais, clique aqui

codigoTipoOperacaointeger required

Insira o código do Tipo de Operação para realizar a inclusão do Financeiro. Esse código é facilmente acessível através da nossa API, na entidade "TipoOperacao" (CODTIPOPER) com o critério TIPMOV = 'I'. Obtenha essa informação e mantenha seus registros sempreatualizados. Para saber mais, clique aqui

codigoNaturezainteger required

Insira o código da Natureza analítica para realizar a inclusão do Financeiro. Esse código é facilmente acessível através da nossa API, na entidade "Natureza" (CODNAT). Obtenha essa informação e mantenha seus registros sempreatualizados. Para saber mais, clique aqui

codigoProjetointeger

Insira o código do Projeto analítico para realizar a inclusão do Financeiro. Esse código é facilmente acessível através da nossa API, na entidade "Projeto" (CODPROJ). Obtenha essa informação e mantenha seus registros sempreatualizados. Para saber mais, clique aqui

codigoCentroResultadointeger required

Insira o código do Centro de Resultado analítico para realizar a inclusão do Financeiro. Esse código é facilmente acessível através da nossa API, na entidade "CentroResultado" (TGFFIN.CODCENCUS). Obtenha essa informação e mantenha seus registros sempreatualizados. Para saber mais, clique aqui

codigoParceirointeger required

Insira o código do Parceiro para realizar a inclusão do Financeiro. Esse código é facilmente acessível através da nossa API, na entidade "Parceiro" (TGFFIN.CODPARC). Obtenha essa informação e mantenha seus registros sempreatualizados. Para saber mais, clique aqui

codigoBancointeger required

Insira o código do Banco para realizar a inclusão do Financeiro. Esse código é facilmente acessível através da nossa API, na entidade "Banco" (TGFFIN.CODBCO).

codigoContaBancariainteger required

Insira o código da Conta Bancária para realizar a inclusão do Financeiro. Esse código é facilmente acessível através da nossa API, na entidade "ContaBancaria" (TGFFIN.CODCTABCOINT). Inserindo o código da conta, o campo Banco (TGFFIN.CODBCO) na movimentação financeiro será preenchido conforme o código do banco vinculado no cadastro da conta. Obtenha essa informação e mantenha seus registros sempre atualizados. Para saber mais, clique aqui

codigoMoedainteger

Código da moeda (TGFFIN.CODMOEDA).

codigoTipoPagamentointeger required

Tipo de Título para o respectivo financeiro. Essa informação deve ser obtida previamente pela entidade "TipoTitulo" (TGFFIN.CODTIPTIT). Para saber mais, clique aqui

numeroNotainteger required

Insira o número da Nota.

dataNegociacaostring required

Data de negociação do financeiro (TGFFIN.DTNEG).

dataVencimentostring required

Data do vencimento do financeiro (TGFFIN.DTVENC).

numeroParcelainteger required

Numero da Parcela (TGFFIN.DESDOBRAMENTO).

valorParcelanumber required

Valor total da parcela (TGFFIN.VLRDESDOB).

maiorNumeroParcelainteger

Maior número de parcela do financeiro, considerando todas as parcelas da mesma nota (máximo de TGFFIN.DESDOBRAMENTO por NUNOTA).

nomeEmpresastring

Nome da empresa vinculada ao financeiro (TSIEMP.NOMEFANTASIA).

nomeTipoOperacaostring

Descrição do tipo de operação do financeiro (TGFTOP.DESCROPER).

nomeNaturezastring

Descrição da natureza financeira (TGFNAT.DESCRNAT).

nomeProjetostring

Descrição do projeto vinculado ao financeiro (TGFPRO.DESCRPROJ).

nomeCentroResultadostring

Descrição do centro de resultado (TSICUS.DESCRCENCUS).

nomeParceirostring

Nome do parceiro vinculado ao financeiro (TGFPAR.NOMEPARC).

Example request

{
  "codigoEmpresa": 1,
  "codigoTipoOperacao": 108,
  "codigoNatureza": 101005,
  "codigoProjeto": 10011,
  "codigoCentroResultado": 3004002,
  "codigoParceiro": 1581,
  "codigoBanco": 1,
  "codigoContaBancaria": 42,
  "codigoMoeda": 22,
  "codigoTipoPagamento": 19,
  "numeroNota": 33569,
  "dataNegociacao": "2025-02-11",
  "dataVencimento": "2025-02-11",
  "numeroParcela": 1,
  "valorParcela": 3.38,
  "maiorNumeroParcela": 10,
  "nomeEmpresa": "TECH SOLUTIONS",
  "nomeTipoOperacao": "VENDAS PARA FORA DO ESTADO",
  "nomeNatureza": "RECEITA COM VENDAS",
  "nomeProjeto": "SEM PROJETO",
  "nomeCentroResultado": "VENDAS PRONTA ENTREGA",
  "nomeParceiro": "JOÃO DA SILVA",
  "cheque": {
    "codigoBarras": "341067330330018805201725766099",
    "numeroCheque": "66009",
    "banco": "341",
    "agencia": "673",
    "conta": "576609",
    "nome": "José da Silva Souza",
    "cnpjCpf": "14532515955",
    "valorCheque": 200
  },
  "cartao": {
    "bandeira": "2",
    "NSU": "123456",
    "rede": "1",
    "parcela": 1,
    "valorTaxa": 0.65
  },
  "boleto": {
    "codigoBarras": "\"341067330330018805201725766099\"",
    "nossoNumero": "568454558",
    "numeroRemessa": "0012",
    "dataPagamento": "13/03/2025 17:22:00"
  },
  "rateios": [
    {
      "codigoNatureza": 101005,
      "codigoProjeto": 10011,
      "codigoCentroResultado": 3004002,
      "codigoParceiro": 1581,
      "codigoContaContabil": 42,
      "percentual": 50
    }
  ]
}

Response

Operação bem sucedida

codigointeger required

tipostring

mensagemstring

Example response

{
  "mensagem": "Financeiro Incluído/Atualizado/Baixado com sucesso.",
  "retorno": {
    "codigoFinanceiro": 8115
  }
}