Histórico da Página

Todo a arquitetura do TOTVS Varejo PDV Omni Smart Hub (POSH) funciona através do envio de lotes.

Podemos imaginar um lote como um container em um navío, esse container contêm os dados que serão enviados para a(s) loja(s).

O envio dos dados segue o seguinte fluxo

1. Abertura de lote 
2. Envio dos dados 
3. Fechamento do lote
4. Monitoramento do lote 

Abaixo está listado cada passo e as informações para o envio.

Os tipos de dados passados na requisição são os seguintes:

    Cliente = 0
    Loja = 1
    Motivo = 2
    Perfil = 3
    Usuario = 4
    FcpProduto = 5
    Compartilhamento = 6
    Imposto = 7
    Ncm = 8
    PisCofins = 9
    TributoNcm = 10
    ClassificacaoProduto = 11
    Produto = 12
    Preco = 13
    Estoque = 14
    Operadora = 15
    DadoComplementarPagto = 16
    CondicaoPagto = 17
    FormaPagto = 18
    CanalVenda = 24
    AlteracaoCliente = 40
    AlteracaoImposto = 47
    AlteracaoNcm = 48
    AlteracaoPisCofins = 49
    AlteracaoTributoNcm = 50
    AlteracaoClassificacaoProduto = 51
    AlteracaoProduto = 52
    AlteracaoPreco = 53
    AlteracaoEstoque = 54
    PreVenda = 55
    ClienteEndereco = 56

Os dados são enviados para os seus respectivos micro serviços.

Exemplo: venda é enviada para o serviço comercial

Todos os dados que serão enviados deverão conter o loteOrigem para identificar de qual lote ele pertence.

Caso o loteOrigem não seja enviado os dados não serão integrados com o PDV Omni.

O lote deve conter o tipo de dado que está sendo enviado

Todo lote que é aberto deve ser fechado após o envio dos dados.

Para se fechar um lote é necessário fazer uma requisição para o micro serviço do PDVSync,Core.Controle.

• Endpoint: /api/retaguarda/inquilinolotesexternos/{IdInquilino}/{LoteOrigem}
• Método: Put
• Autenticação: Bearer token
• Permissão: Retaguarda

Ao ser fechado o lote começa a ser processado pela inteligência do POSH, nesse momento são feitas várias verificações de integridade dos dados e há um processo para enviar os dados para todas as lojas que fazem parte do compartilhamento.

O monitoramento do lote pode ser feito de várias formas.

Antes é necessário que haja o entendimento que há dois tipos de lote.

• Lote Externo - Lote criado pela retaguarda que identifica os dados que serão enviados
• Loja Lote - Lote criado pelo POSH para enviar para o PDV Omni

O loja lote é criado pelo POSH quando o lote externo é fechado pela Retaguarda, o passo a passo é o seguinte:

1. Retaguarda fecha o lote 
2. O POSH verifica os dados do lote
3. O POSH verifica os corpartilhamentos do inquilino
4. O POSH cria os loja lotes de acordo com os compartlhamentos do inquilino

Nesse módulo teremos a explicação de como fazer o monitoramento dos dois tipos de lotes.

IMPORTANTE: O POSH tem rotinas de expurgo de dados que rodam automaticamente todos os dias, os dados ficam nos serviços do POSH por 14 dias corridos, depois disso não há como recuperar as informações dos lotes.

O monitoramento do lote externo é feito pelas apis do PDVSync.Core.Controle.

Nesse endpoint teremos algumas informações muito importante com relação ao lote aberto pela retaguarda.

• Endpoint: /api/retaguarda/v2/inquilinolotesexternos/{id lote externo}
• Método: GET
• Autenticação: Bearer token
• Permissão: Retaguarda

Nesse endpoint um dos dados mais importantes é o status, ele indica se o lote prosseguiu para o próximo passo ou se ele foi barrado por algum motivo.

{
    "success": bool,
    "message": "string",
    "data": {
        "lote": "string",
        "loteOrigem": "string",
        "lojaLotes": [
            {
                "status": int,
                "errosIdentificados": [
                    {
                        "tipoLote": int,
                        "idRetaguarda": "string",
                        "erro": "string",
                        "tipoLojaLote": int
                    }
                ],
                "idRetaguardaLoja": "string",
                "idInquilino": "string",
                "dataAtualizacao": "datetime",
                "dataCadastro": "datetime",
                "id": int
            }
        ],
        "pagina": int,
        "hasnext": bool
    }
}