--- title: "Atualizar Receitas" method: PUT path: "/v1/financeiros/receitas/{codigoFinanceiro}" tags: ["Financeiros Movimentos"] --- # Atualizar Receitas `PUT /v1/financeiros/receitas/{codigoFinanceiro}` Endpoint `PUT /v1/financeiros/receitas/{codigoFinanceiro}` - Atualiza os dados financeiros de receitas cadastrados no SankhyaOM. ## Path parameters - `codigoFinanceiro` integer, required ## Request body - FinanceiroAtualizarIncluir — Os atributos apresentados aqui estão vinculados ao financeiro da nota, mapeados pela entidade "Financeiro". Para personalizar a integração é possível enviar os atributos dessa entidade, como "DTVENC" em vez de "dataVencimento". Além disso, é possível utilizar campos que, embora não estejam detalhados nesta documentação, fazem parte do dicionário de dados. - `codigoEmpresa` integer, 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](https://developer.sankhya.com.br/reference/get_loadrecords) - `codigoTipoOperacao` integer, 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](https://developer.sankhya.com.br/reference/get_loadrecords) - `codigoNatureza` integer, 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](https://developer.sankhya.com.br/reference/get_loadrecords) - `codigoProjeto` integer — 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](https://developer.sankhya.com.br/reference/get_loadrecords) - `codigoCentroResultado` integer, 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](https://developer.sankhya.com.br/reference/get_loadrecords) - `codigoParceiro` integer, 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](https://developer.sankhya.com.br/reference/get_loadrecords) - `codigoBanco` integer, 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). - `codigoContaBancaria` integer, 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](https://developer.sankhya.com.br/reference/get_loadrecords) - `codigoMoeda` integer — Código da moeda (TGFFIN.CODMOEDA). - `codigoTipoPagamento` integer, 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](https://developer.sankhya.com.br/reference/get_loadrecords) - `numeroNota` integer, required — Insira o número da Nota. - `dataNegociacao` string, required — Data de negociação do financeiro (TGFFIN.DTNEG). - `dataVencimento` string, required — Data do vencimento do financeiro (TGFFIN.DTVENC). - `numeroParcela` integer, required — Numero da Parcela (TGFFIN.DESDOBRAMENTO). - `valorParcela` number, required — Valor total da parcela (TGFFIN.VLRDESDOB). - `maiorNumeroParcela` integer — Maior número de parcela do financeiro, considerando todas as parcelas da mesma nota (máximo de TGFFIN.DESDOBRAMENTO por NUNOTA). - `nomeEmpresa` string — Nome da empresa vinculada ao financeiro (TSIEMP.NOMEFANTASIA). - `nomeTipoOperacao` string — Descrição do tipo de operação do financeiro (TGFTOP.DESCROPER). - `nomeNatureza` string — Descrição da natureza financeira (TGFNAT.DESCRNAT). - `nomeProjeto` string — Descrição do projeto vinculado ao financeiro (TGFPRO.DESCRPROJ). - `nomeCentroResultado` string — Descrição do centro de resultado (TSICUS.DESCRCENCUS). - `nomeParceiro` string — Nome do parceiro vinculado ao financeiro (TGFPAR.NOMEPARC). - `cheque` ApiFinanceirocheque — Esta informação deve ser enviada "apenas" quando a opção de pagamento (atributo "codigoTipoPagamento") seja do subtipo "Cheque" ("4"). Recebe dados de Cheque utilizado como meio de pagamento - `codigoBarras` string, required — Código de barras do cheque (TGFCHQ.CMC7) - `numeroCheque` string — Número do cheque (TGFCHQ.NUMCHEQUE) - `banco` string — Código Banco emissor do cheque (TGFCHQ.CODBCO) - `agencia` string — Agência bancária emissora do cheque (TGFCHQ.AGENCIA) - `conta` string — Número conta bancária emissora do cheque (TGFCHQ.CONTA) - `nome` string — Nome emitente do cheque (TGFCHQ.NOMEEMITENTE) - `cnpjCpf` string — CNPJ/CPF emitente (TGFCHQ.CGC_CPF) - `valorCheque` number, required - `dataCheque` string, date — Data do Cheque (TGFCHQ.DATACHEQUE) - `cartao` ApiFinanceirocartao — Esta informação deve ser enviada "apenas" quando a opção de pagamento (atributo "codigoTipoPagamento") seja do subtipo 7 - Cartão de crédito ("7") ou Cartão de débito"Cheque" ("8"). Recebe dados da transação do cartão utilizado como meio de pagamento. - `bandeira` string, required — Segue padrão para bandeiras de cartões de créditos disponível no layout da nota fiscal eletronica (TGFTEF.BANDEIRA). As Bandeiras são cadastradas na tela "Bandeiras Tef" no SankhyaOM (TSIBTEF.BANDEIRA). Esse código é facilmente acessível através da nossa API, no endpoint "GET /v1/bandeirasTef". Obtenha essa informação e mantenha seus registros sempre atualizados. - `autorizacao` string, required — Código de autorização na transação fornecedido pela administradora do cartão de crédito (TGFTEF.AUTORIZACAO). - `NSU` string — NSU da transação fornecedido pela administradora do cartão de crédito (TGFTEF.NUMNSU) - `rede` string, required — Código da Rede (Adquirente) do cartão (TGFTEF.REDE). As Redes são cadastradas na tela "Rede Tef" no SankhyaOM (TSIRTEF.REDE). Esse código é facilmente acessível através da nossa API, no endpoint "GET /v1/redesTef". Obtenha essa informação e mantenha seus registros sempre atualizados. - `parcela` integer, required — Número da Parcela fornecida pela administradora do cartão de crédito (TGFTEF.DESDOBRAMENTO) - `dataHoraTransacao` string, datetime, required — Data e Hora da Transação fornecida pela administradora do cartão de crédito (TGFTEF.DTTRANSACAO) - `valorTaxa` number, required — Valor da Taxa fornecedida pela administradora do cartão de crédito (TGFTEF.VLRTAXA) - `boleto` Boleto — Esta informação deve ser enviada "apenas" quando a opção de pagamento (atributo "codigoTipoPagamento") seja do subtipo "A prazo" ("2"). Recebe dados de boleto utilizado como meio de pagamento - `codigoBarras` string, required — Código de Barras do boleto (TGFFIN.CODBARRA) - `nossoNumero` string, required — "Nosso numero" do boleto (TGFFIN.NOSSONUM) - `linhaDigitavel` string, required — "Nosso numero" do boleto (TGFFIN.LINHADIGITAL) - `numeroRemessa` string — "Nosso numero" do boleto (TGFFIN.NUMREMESSA) - `dataPagamento` string, required — Data e Hora do Pagamento do Boleto (TGFFIN.TIMDHBAIXA) - `rateios` Rateio[] - `codigoNatureza` integer, required — Insira o código da Natureza para realizar a inclusão do Financeiro. Esse código é facilmente acessível através da nossa API, na entidade "Natureza" (TGFRAT.CODNAT). Obtenha essa informação e mantenha seus registros sempreatualizados. Para saber mais, [clique aqui](https://developer.sankhya.com.br/reference/get_loadrecords) - `codigoProjeto` integer — Insira o código do Projeto para realizar a inclusão do Financeiro. Esse código é facilmente acessível através da nossa API, na entidade "Projeto" (TGFRAT.CODPROJ). Obtenha essa informação e mantenha seus registros sempreatualizados. Para saber mais, [clique aqui](https://developer.sankhya.com.br/reference/get_loadrecords) - `codigoCentroResultado` integer, required — Insira o código do Centro de Resultado para realizar a inclusão do Financeiro. Esse código é facilmente acessível através da nossa API, na entidade "CentroResultado" (TGFRAT.CODCENCUS). Obtenha essa informação e mantenha seus registros sempreatualizados. Para saber mais, [clique aqui](https://developer.sankhya.com.br/reference/get_loadrecords) - `codigoParceiro` integer — 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" (TGFRAT.CODPARC). Obtenha essa informação e mantenha seus registros sempreatualizados. Para saber mais, [clique aqui](https://developer.sankhya.com.br/reference/get_loadrecords) - `codigoContaContabil` integer — 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" (TGFRAT.CODCTABCOINT). Obtenha essa informação e mantenha seus registros sempre atualizados. Para saber mais, [clique aqui](https://developer.sankhya.com.br/reference/get_loadrecords) - `percentual` number, required — Percentual do rateio (TGFRAT.PERCRATEIO) ## Response `200` Operação bem sucedida. Clique [aqui](https://developer.sankhya.com.br/reference/c%C3%B3digos-de-retorno-da-api) para mais detalhes. - RetornoMovimentoFinanceiro - `codigo` integer, required - `tipo` string - `mensagem` string - `retorno` NumeroFinanceiro - `codigoFinanceiro` integer, required — Insira o código do Financeiro para realizar baixa. Esse código é facilmente acessível através da nossa API, na entidade "Financeiro" (NUFIN). Obtenha essa informação e mantenha seus registros sempre atualizados. Para saber mais, [clique aqui](https://developer.sankhya.com.br/reference/get_loadrecords) --- [API](https://skmtc.net/sankhya/apis/api-sankhya.md) · [All operations](https://skmtc.net/sankhya/apis/api-sankhya/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sankhya/api-sankhya/revisions/0a3e81ca6195/schema)