TOTVS Varejo PDV Omni

Árvore de páginas


O ESTOQUE poderá ter a seguintes informações:

    Informação

    Coluna

    Obrigatório

    Tipo

    Tamanho

    Descrição
    Saldo em estoque

    saldo

    Não

    Inteiro

    Corresponde ao valor em estoque do produto em questão recebido pela integração.
    Identificação no retaguarda

    id_retaguarda

    Não

    Texto

    100


    Sincronizado

    sincronizado

    Não

    Inteiro


    Defasado. Valor sempre 1.
    Data de cadastro

    data_cadastro

    Sim

    Data


    Exemplo "2024-03-20 20:56:43.15725". Corresponde a data em que o dado foi cadastrado localmente.
    Data de atualização

    data_atualizacao

    Sim

    Data


    Exemplo "2024-03-20 20:56:43.15725". Corresponde a data em que o dado foi atualizado localmente.
    Situação

    situacao

    Sim

    Inteiro


    Define se o estoque em questão está ativo ou inativo.

    • 0 - Inativo
    • 1 - Ativo
    Identificação do produto

    id_produto

    Sim

    Inteiro


    Identificação do produto, vinculado ao "ID" da tabela produto
    MD5 PAF

    md5_paf

    Não

    Texto

    64


    Saldo PAF

    saldo_paf

    Não

    Numérico


    Data atualização PAF

    data_atualizacao_paf

    Não

    Data



    Estoque online

    O PDV pode operar com o estoque local, sempre verificando e subtraindo sobre a tabela de estoque. E também com o estoque online.

    Com o parâmetro de estoque online ativo (chave 25 - "Utilizar estoque on-line?"), os dados da tabela estoque são desconsiderados. A cada nova consulta o PDV irá verificar no retaguarda/ERP qual o saldo de estoque do item.

    Venda sem estoque

    É possível no PDV permitir ou bloquear a venda de produtos com estoque negativo, caso haja a necessidade devido alguma intercorrência no inventário. Para habilitar a venda de produtos sem estoque é necessário ativar o parâmetro chave 23 - "Permitir venda de produtos sem estoque?". O valor configurado irá refletir tanto no estoque local quanto no estoque online.

    • Endpoints:
      • /api/retaguarda/v2/estoques
      • /api/retaguarda/v3/estoques
      • /dadosdinamicos/down/14/{versãoJson}
    • Método: POST
    • Autenticação: Bearer token
    • Permissão: Retaguarda
    • Microserviço: PDVSync.Core.Estoque

    Este endpoint recebe uma lista de preços para que possam ser enviados vários na mesma requisição

    Para que a baixa do Estoque criado ocorra no PDV Omni é necessário realizar a abertura de um lote do tipo  14 = estoque

    Requisição

    Exemplo de body da requisição

    [
        {
            "codigoProduto": "string",
            "idInquilino": "string",
            "idProprietario": "string",
            "idRetaguarda": "string",
            "idRetaguardaProduto": "string",

             "produtoLote": [
                 {
                  "situacao": 0,
                   "quantidade": 0,
                  "identificacaoLote": "string",
                  "dataValidade": "2025-01-29T17:29:33.798Z",
                  "estoqueIdRetaguarda": "string",
                  "idRetaguarda": "string"
                }
             ],
            "loteOrigem": "string",
            "saldo": "string",
            "situacao": 0
        }
    ]

    Definições dos campos do body

    Campo

    Tipo

    Descrição

    Obrigatório

    Observações
    idRetaguardaProduto String Identificador do produto na retaguarda Sim Tamanho máximo: 100 caracteres
    codigoProduto String Código do produto Sim
    saldo String Saldo do estoque do produto Sim
    situacao Inteiro Situação do estoque  Sim 0 - Inativo, 1 - Ativo
    produtoLote Lista de Objetos Lista de Identificação do Lote do Produto Não
    produtoLote.situacao Inteiro Identifica se o registro esta ativo ou inativo Sim 0 - Inativo, 1 - Ativo
    produtoLote.quantidade Decimal Quantidade de produtos disponível no lote. Sim Maior que zero
    produtoLote.identificacaoLote String Código ou identificação única do lote. Sim Tamanho máximo: 15 caracteres
    produtoLote.dataValidade Data/Hora Data de validade do lote. Não
    produtoLote.estoqueIdRetaguarda String Identificador do estoque na retaguarda Sim Tamanho máximo: 100 caracteres
    produtoLote.idRetaguarda String Identificador do lote do produto na retaguarda. Sim Tamanho máximo: 100 caracteres
    idInquilino String Identificador do inquilino Sim
    idRetaguarda String Identificador do estoque na retaguarda Sim Tamanho máximo: 100 caracteres
    idProprietario String Identificador do proprietário Sim
    loteOrigem String Identificador do lote em que os dados serão enviados Sim

    Retorno

    Exemplo de body de retorno

    {
        "success": true,
        "message": "Requisição inserida com sucesso!",
        "data": null,
        "errors": null,
        "totalTime": 0,
        "numberOfRecords": 0
    }

    Definições dos campos do retorno

    Campo

    Tipo

    Descrição
    Success bool Indica se a criação do compartilhamento foi feita com sucesso
    Message string Caso ocorra erros durante a criação do compartilhamento eles serão enviados nesse campo
    Data objeto Objeto compartilhamento criado
    Errors Lista Listas com os erros encontrados no processo
    TotalTime int tempo da requisição
    NumberOfRecords int número de dados inseridos

    Exemplo de body de retorno

    {
        "code": "string",
        "message": "string",
        "detailedMessage": "string",
        "helpUrl": "string",
        "details": [
            {
                "guid": "string",
                "code": "string",
                "message": "string",
                "detailedMessage": "string"
            }
        ]
    }

    Definições dos campos do retorno

    Campo

    Tipo

    Descrição
    code string Código de erro
    message string Mensagem do erro
    detailedMessage string Detalhamento do erro
    helpUrl string url de ajuda
    TotalTime string Tempo total de busca
    details lista de objeto Lista de objeto de erros
    details.guid string Identificador do erro
    details.code string Código do erro
    details.message string Mensagem do erro 
    details.detailedMessage string Detalhamento do erro

    Este endpoint ainda está em processo de manutenção, as informações estão disponibilizadas apenas para consulta, não sendo possível realizar a requisição.

    Requisição

    Exemplo de body da requisição

    [
        {
            "dataAtualizacaoPaf": "2000-01-01",
            "idInquilino": "string",
            "idProprietario": "string",
            "idRetaguarda": "string",
            "idRetaguardaProduto": "string",

             "produtoLote": [
                 {
                  "situacao": 0,
                   "quantidade": 0,
                  "identificacaoLote": "string",
                  "dataValidade": "2025-01-29T17:29:33.798Z",
                  "estoqueIdRetaguarda": "string",
                  "idRetaguarda": "string"
                }
             ],
            "loteOrigem": "string",
            "saldo": 0,
            "saldoPaf": 0.0,
            "situacao": 0
        }
    ]

    Definições dos campos do body

    Campo

    Tipo

    Descrição

    Obrigatório

    Observações
    idRetaguardaProduto String Identificador do produto na retaguarda Sim Tamanho máximo: 100 caracteres
    saldoPaf numérico Saldo PAF Não
    saldo Int Saldo do estoque do produto Sim
    situacao Inteiro Situação do estoque  Sim 0 - Inativo, 1 - Ativo
    produtoLote Lista de Objetos Lista de Identificação do Lote do Produto Não
    produtoLote.situacao Inteiro Identifica se o registro esta ativo ou inativo Sim 0 - Inativo, 1 - Ativo
    produtoLote.quantidade Decimal Quantidade de produtos disponível no lote. Sim Maior que zero
    produtoLote.identificacaoLote String Código ou identificação única do lote. Sim Tamanho máximo: 15 caracteres
    produtoLote.dataValidade Data/Hora Data de validade do lote. Não
    produtoLote.estoqueIdRetaguarda String Identificador do estoque na retaguarda Sim Tamanho máximo: 100 caracteres
    produtoLote.idRetaguarda String Identificador do lote do produto na retaguarda. Sim Tamanho máximo: 100 caracteres
    idInquilino String Identificador do inquilino Sim
    idRetaguarda String Identificador do estoque na retaguarda Sim Tamanho máximo: 100 caracteres
    idProprietario String Identificador do proprietário Sim
    loteOrigem String Identificador do lote em que os dados serão enviados Sim
    dataAtualizacaoPaf Datetime Data de atualização do Paf Não

    Retornos

    Exemplo de body de retorno

    {
        "success": true,
        "message": "Requisição inserida com sucesso!",
        "data": null,
        "errors": null,
        "totalTime": 0,
        "numberOfRecords": 0
    }

    Definições dos campos do retorno

    Campo

    Tipo

    Descrição
    Success bool Indica se a criação do compartilhamento foi feita com sucesso
    Message string Caso ocorra erros durante a criação do compartilhamento eles serão enviados nesse campo
    Data objeto Objeto compartilhamento criado
    Errors Lista Listas com os erros encontrados no processo
    TotalTime int tempo da requisição
    NumberOfRecords int número de dados inseridos

    Exemplo de body de retorno

    {
        "code": "string",
        "message": "string",
        "detailedMessage": "string",
        "helpUrl": "string",
        "details": [
            {
                "guid": "string",
                "code": "string",
                "message": "string",
                "detailedMessage": "string"
            }
        ]
    }

    Definições dos campos do retorno

    Campo

    Tipo

    Descrição
    code string Código de erro
    message string Mensagem do erro
    detailedMessage string Detalhamento do erro
    helpUrl string url de ajuda
    TotalTime string Tempo total de busca
    details lista de objeto Lista de objeto de erros
    details.guid string Identificador do erro
    details.code string Código do erro
    details.message string Mensagem do erro 
    details.detailedMessage string Detalhamento do erro



    • Sem rótulos