Registra a integração de vendas com a folha

PUT 
/v1/venda

Para cada item, grava a data e o status de integração quando a venda existe. Itens inexistentes são retornados individualmente com status false; eles não fazem a operação inteira falhar. O único status aceito é "1".

Authorization

Autentique-se em POST /v1/autenticacao e informe no campo Bearer Token somente o valor da propriedade token retornada. A interface enviará o cabeçalho Authorization: Bearer TOKEN automaticamente.

Request

application/json

Body

Body

required

vendas

object[]

required

Array [

id int64required

dthrIntegradoFolha date-timerequired

]

vendaIntegrada

{
  "vendas": [
    {
      "id": 533,
      "statusIntegradoFolha": "1",
      "dthrIntegradoFolha": "2026-07-13T20:31:00"
    }
  ]
}

Responses

200

Resultado individual da atualização de cada venda.

application/json

Schema

Schema

success booleanrequired
message stringnullablerequired
total int64required

data

object[]

required

Array [

id int64required

status booleanrequired

]

Example (from schema)

{
  "success": true,
  "message": "string",
  "total": 0,
  "data": [
    {
      "id": 0,
      "status": true,
      "message": "string"
    }
  ]
}

sucesso

{
  "success": true,
  "message": null,
  "total": 1,
  "data": [
    {
      "id": 533,
      "status": true
    }
  ]
}

vendaInexistente

{
  "success": true,
  "message": null,
  "total": 1,
  "data": [
    {
      "id": 999999,
      "status": false,
      "message": "Id da venda não localizado"
    }
  ]
}

422

Falha de binding ou validação dos parâmetros recebidos.

application/json

Schema

Schema

success booleanrequired
message stringrequired
total int64
data undefined[]
cause stringnullable

Example (from schema)

{
  "success": false,
  "message": "Invalid call of API.",
  "total": 0,
  "data": [
    null
  ],
  "cause": "string"
}

Loading...