--- title: "Registra recebimento para um Caixa/PDV" method: POST path: "/v1/caixa/recebimento" tags: ["Vendas Gestão de Caixa"] --- # Registra recebimento para um Caixa/PDV `POST /v1/caixa/recebimento` Registra recebimento para um Caixa/PDV. ## Request body - RecebimentoIncluir — 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. - `tipoPagamento` integer, required — Tipo de Título para o respectivo financeiro. Essa informação deve ser obtida previamente pela entidade "TipoTitulo" (CODTIPTIT). Para saber mais, [clique aqui](https://developer.sankhya.com.br/reference/get_loadrecords) - `cheque` Cheque — Esta informação deve ser enviada "apenas" quando a opção de pagamento (atributo "tipoPagamento") seja do tipo "Cheque" ("02"). Recebe dados de Cheque utilizado como meio de pagamento - `codigoBarras` string - `banco` string - `agencia` string - `conta` string - `numero` string - `nome` string - `cnpjCpf` string - `cartao` Cartao - `bandeira` string — Segue padrão para bandeiras de cartões de créditos disponível no layout da nota fiscal eletronica. - 01 - Visa - 02 - Mastercard - 03 - American Express - 04 - Sorocred - 05 - Diners Club - 06 - Elo - 07 - Hipercard - 08 - Aura - 09 - Cabal - 99 - Outros - `autorizacao` string — Código de autorização na transação fornecedido pela administradora do cartão de crédito. Informação utilizada para conciliação financeira. - `dataVencimento` string, required — Data do vencimento do financeiro. - `dataBaixa` string, required — Data da baixa do recebimento - `valorParcela` number, required — Valor total da parcela. - `idTransacao` string — ID da transação quando houver. Por exemplo o protocolo da transação PIX. - `codigoCaixa` integer, required — Identificador do Caixa/PDV que está aberto. Esta informação é retonrada ao abrir o caixa e pode ser consultada também pelo endpoint caixa/{codigoPdv}/{cpfOperador} - `valorBaixa` number, required — Valor da baixa do recebimento - `valorJuro` number — Valor de juros do recebimento - `valorMulta` number — Valor de multa do recebimento - `valorDesconto` number — Valor de desconto do recebimento - `identificador` string — Número identificador do recebívelf, pode ser o código de barras, nosso número, ou algum outra informação que seja capaz de identificar o finaceiro recebido. - `observacao` string - `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 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 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 — 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" (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" (CODPARC). Obtenha essa informação e mantenha seus registros sempreatualizados. Para saber mais, [clique aqui](https://developer.sankhya.com.br/reference/get_loadrecords) ## Response `200` Operação bem sucedida - RetornoMovimento - `codigo` integer - `tipo` string - `mensagem` string ## Other responses - `400` — Informações Inválidas. Clique [aqui](https://developer.sankhya.com.br/reference/c%C3%B3digos-de-retorno-da-api) para mais detalhes. - `401` — Não autenticado. Clique [aqui](https://developer.sankhya.com.br/reference/c%C3%B3digos-de-retorno-da-api) para mais detalhes. - `403` — Autenticação inválida. Clique [aqui](https://developer.sankhya.com.br/reference/c%C3%B3digos-de-retorno-da-api) para mais detalhes. - `404` — Dados não encontrados. Clique [aqui](https://developer.sankhya.com.br/reference/c%C3%B3digos-de-retorno-da-api) para mais detalhes. - `500` — Erro interno no servidor. Clique [aqui](https://developer.sankhya.com.br/reference/c%C3%B3digos-de-retorno-da-api) para mais detalhes. - `501` — Não implementado. Clique [aqui](https://developer.sankhya.com.br/reference/c%C3%B3digos-de-retorno-da-api) para mais detalhes. - `502` — Retorno inválido do servidor. Clique [aqui](https://developer.sankhya.com.br/reference/c%C3%B3digos-de-retorno-da-api) para mais detalhes. - `503` — Serviço indisponível no momento. Clique [aqui](https://developer.sankhya.com.br/reference/c%C3%B3digos-de-retorno-da-api) para mais detalhes. - `504` — Tempo de execução excedido. Clique [aqui](https://developer.sankhya.com.br/reference/c%C3%B3digos-de-retorno-da-api) para mais detalhes. --- [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)