TOTVS Varejo PDV Omni

Árvore de páginas

Para permitir uma gestão centralizada e automatizada das regras de precificação no TOTVS Varejo PDV Omni é necessário que o mesmo possua uma região relacionada aos preços. Isso permite futuras expansões e ajustes nas políticas de preços, suportando promoções, preços fixos e dinâmicos de forma flexível e escalável. 

O cadastro de região irá permitir as seguintes configurações:


    Informação Coluna Obrigatório Tipo Tamanho Descrição
    Descrição

    descricao

    Sim

    		 Texto

    40

    Descrição da Região
    Situação da Região situacao Sim Inteiro

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

    • 0 - Inativo
    • 1 - Ativo
    Data cadastro data_cadastro Sim Data
    		Exemplo "2024-03-20 20:56:43.15725". Corresponde a data em que o dado foi cadastrado localmente.
    Data atualização data_atualizacao Sim Data
    		Exemplo "2024-03-20 20:56:43.15725". Corresponde a data em que o dado foi atualizado localmente.
    Identificação no retaguarda id_retaguarda Sim Texto 100
    Uf uf Não Texto 2

    Unidade federativa
    Frete Percentual frete_percentual Não Numérico
    		O percentual de frete associado à região. 
    Frete Terceiros frete_terceiros Não Numérico
    		O valor de frete para terceiros
    Frete Especial frete_especial Não Numérico
    		Valor de frete especial
    Frete Kg frete_kg Não Numérico
    		Valor do frete por Kg

    Este método é responsável pela criação de um novo perfil

    • Endpoint: /api/retaguarda/v3/dadosdinamicos/down/100/1
    • Método: Post
    • Autenticação: Bearer token
    • Permissão: Retaguarda

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

    Para que a baixa da região criado ocorra no PDV Omni é necessário realizar a abertura de um lote do tipo 100 = regiao

    Requisição

    Exemplo de body da requisição

    [
        {
            "idInquilino": "string",
            "idRetaguarda": "string",
            "descricao": "string",
            "fretePercentual": 0.0,
            "freteTerceiros": 0.0,
            "freteEspecial": 0.0,
            "freteKg": 0.0,
            "idProprietario": "string",
            "idRetaguardaLoja": "string",
            "loteOrigem": "string",
            "situacao": 0,
            "uf": "string"
        }
    ]


    Definições dos campos do body

    Campo Tipo Descrição Obrigatório Observações
    idInquilino string Identificação do inquilino Sim
    idRetaguarda string Identificação no retaguarda Sim Tamanho máximo: 100 caracteres
    descricao string

    Descrição da Região.

    Sim

    Tamanho máximo: 40 caracteres
    fretePercentual float Frete Percentual Não O percentual de frete associado à região. 
    freteTerceiros float Frete Terceiros Não O valor de frete para terceiros
    freteEspecial float Frete Especial Não Valor de frete especial
    freteKg float Frete Kg Não Valor do frete por Kg
    idProprietario
    		identificador do proprietário Sim
    idRetaguardaLoja
    		Identificação da loja
    		Tamanho máximo: 100 caracteres
    loteOrigem
    		Lote vinculado ao dado Sim
    situacao Inteiro

    Situação da Região

    		 Sim

    Define se a região em questão está ativa ou inativa.

    • 0 - Inativo
    • 1 - Ativo
    uf string

    Uf

    		 Não

    Unidade federativa

    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




    • Sem rótulos