Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

API responsável por enviar os dados consolidados de venda/, caixa /ou operações do TOTVS PDV Omni através do serviço UPPDVSync.Client.Serviço.UP (Serviço responsável pela subida de dados do TOTVS PDV Omni para o retaguarda).

IMPORTANTE: API de uso exclusivo do client.

Para acessar os dados a requisição é a seguinte

...

O endpoint recebe uma lista de vendas dados consolidados para que seja possivel enviar várias na mesma requisição.

Expandir
titleExemplo de body da requisição

[
   {
       "idMensagemidInquilino": "string",
        "observacao"dataAtualizacao": "2024-05-06T14:35:08.208Z",
     "dataCadastro": "2024-05-06T14:35:08.208Z",
     "idRetaguardaLoja": "string",
     "tipoDado": 1,
     "numeroRegistros": 0,
      "numeroRegistrosConfirmados": 0,
      "status": 0,
      "conteudo": "string",
      "observacao": "string"
   }
]

Expandir
titleDefinição dos campos de requisição

Campo

Tipo

Descrição

Observações

idMensagem

IdInquilinoStringCódigo do Id do InquilinoObrigatório
DataAtualizacaoDateTimeData de Atualização do RegistroObrigatório
DataCadastroDateTimeData de Criação do RegistroObrigatório
IdRetaguardaLojaString
Identificador da venda no POSH
Código do Id Retaguarda da LojaObrigatório
TipoDadoEnumTipo do Dado Consolidado (Valores atribuídos no quadro abaixo)Obrigatório
NumeroRegistrosIntegerNúmero de Registros Enviados para o RetaguardaObrigatório
observacao
NumeroRegistrosConfirmados
StringObservação enviada pela retaguarda

Opcional

IntegerNúmero de Registros Confirmados pelo RetaguardaOpcional (Nesse primeiro momento, enviar esse campo com o valor igual à 0) 
StatusIntegerStatus da confirmação do Dado Consolidado (Valores atribuídos no segundo quadro abaixo)Obrigatório
ConteudoTextConteúdo do Dado Consolidado em Base64 (Definições abaixo)Obrigatório
ObservacaoStringObservação (pode ser utilizado como Log
statusIntStatus da venda (Definições abaixo
)Opcional
Expandir
titleTipo Dado Consolidado
CódigoStatus
1Venda
Expandir
titleStatus
Integrado com sucesso pela retaguarda
CódigoStatusDescrição
0ProcessarPendentePendente consumo pela retaguardade confirmação do Retaguarda
1ProcessadaConfirmado com SucessoRecebimento confirmado com sucesso pela RetaguardaConsumido pela retaguarda
2Confirmado com ErroConsumido com erro pela retaguarda
3ReprocessarPara reprocessar
4IntegradoComSucesso
Recebimento confirmado com erro

* O serviço PDVSync.Client.Servico.Up sempre irá enviar o Dado Consolidado com o status 0 (Pendente).

Expandir
titleConteúdo - Base 64

O conteúdo enviado em base64 segue o padrão abaixo:

[{
        "VendaId": 1967,
        "ChaveAcesso": "43240482373077000171655480000101371858920188",
        "SerieNota": 548,
        "ccf": "10137",
        "ValorBruto": 15.41,
        "DataAtualizacao": "2024-04-26T17:46:09.686751",
        "DataCadastro": "2024-04-26T17:44:18.427249",
        "DataEmissao": "2024-04-26T17:44:18.265702",
        "SituacaoVenda": 0,
        "IdRetaguardaLoja": "1",
        "NumeroPDV": "13"
    }]

Expandir
titleDefinição dos campos de retorno
Expandir
title200 - Ok

Campo

Tipo

Descrição

SuccessboolIndica se a criação do compartilhamento dado consolidado foi feita com sucesso
MessagestringCaso ocorra erros durante a criação do compartilhamento dado consolidado eles serão enviados nesse campo
DataobjetoObjeto compartilhamento dado consolidado criado
ErrorsListaListas com os erros encontrados no processo
TotalTimeinttempo Tempo da requisição
NumberOfRecordsintnúmero Número de dados inseridos
Expandir
titleBody de retorno

{
    "success": true,
    "message": "",
    "data": null,
    "errors": null,
    "totalTime": 0,
    "numberOfRecords": 0
}

Expandir
title400 - Bad Request

Campo

Tipo

Descrição

SuccessboolIndica se a criação do compartilhamento dado consolidado foi feita com sucesso
MessagestringCaso ocorra erros durante a criação do compartilhamento dado consolidado eles serão enviados nesse campo
DataobjetoObjeto compartilhamento dado consolidado criado
ErrorsListaListas com os erros encontrados no processo
TotalTimeinttempo Tempo da requisição
NumberOfRecordsintnúmero Número de dados inseridos
Expandir
titleBody de retorno

{
    "success": false,
    "message": "",
    "data": null,
    "errors": null,
    "totalTime": 0,
    "numberOfRecords": 0
}