v1

latestOpenAPI 3.0.3Licença Sankhya2026-07-24161242654.8 KB

Vendas Gestão de Caixa

Registra a abertura do Caixa/PDV

Este endpoint permite realizar a abertura de um Caixa/PDV no SankhyaOm. Para que o processo ocorra corretamente, o operador deve estar previamente vinculado ao cadastro do PDV no SankhyaOm.

É importante observar que o SankhyaOm não permite mais de um "Caixa Aberto" simultaneamente para o mesmo PDV, isso para garantir a integridade da operação.

Ao abrir o Caixa/PDV, a API retornará o identificador codigoCaixa, que representa o "Caixa Aberto" para o período em questão. Esse codigoCaixa deve ser utilizado para realizar o fechamento do caixa e vincular todos os movimentos de venda ao respectivo "Caixa Aberto", garantindo a correta rastreabilidade das operações.

post/v1/caixa/abertura

Request body

codigoPdvinteger required

Código do PDV a ser aberto. Esse código é acessível através da nossa API, na entidade "CadastroPDV" (codigoPdv). Obtenha essa informação mantenha seus registros sempre atualizados. Para saber mais, clique aqui

cpfOperadorstring required

Insira o CPF do operador de Caixa/PDV para localizar o Operador do Caixa vinculado ao PDV. Com essa informação, a API identifica o operador responsável no PDV e o vincula ao movimento. Para mais detalhes sobre o cadastro de usuários, clique aqui

datastring required

Data da abertura do Caixa/PDV

horastring required

Hora da abertura do Caixa/PDV

observacaostring

Example request

{
  "codigoPdv": 11,
  "cpfOperador": "15975325800",
  "data": "26/10/2024",
  "hora": "08:54",
  "observacao": "Observações referente a abertura do Caixa/PDV"
}

Response

Operação bem sucedida

codigoCaixainteger

Identificador do Caixa/PDV aberto.

datastring

Data da abertura do Caixa/PDV

horastring

Hora da abertura do Caixa/PDV

Example response

{
  "codigoCaixa": 315,
  "data": "26/10/2024",
  "hora": "08:54"
}