APIs Integrações - Tipos de Cobranças - EM HOMOLOGAÇÃO

Objetivo

Este documento tem como objetivo explicar o funcionamento da api de consulta de tipos de cobranças (Rotina 522).

Pré-Requisitos e Restrições

Necessário instalar o serviço winthor-vendas na rotina 801 do WTA, conforme indicação Parametrizações WTA.

Integração

Este documento tem como objetivo explicar o funcionamento da api de consulta de tipos de cobranças (Rotina 522).

Os dados integrados são:

PCCOB, PCCOBPLPAG, PCPLPAG, PCOPERADORACARTAO
API	Referência Winthor	Obs
id	pccob.codcob
cobranca	pccob.cobranca
cartao	pccob.cartao
boleto	pccob.boleto
nivelvenda	pccob.nivelvenda
codigoFilial	pccob.codfilial
tipoOperacaoTef	pccob.tipooperacaotef
tipoPagtoEcf	pccob.tipopagtoecf
prazoMaximoVenda	pccob.prazomaximovenda
codMoeda	pccob.codMoeda
codCliente	pccob.codclicc
dataAtualizacao	pccob.dtultalter
dataCadastro	pccob.dtcadastro
planoPagamentos	pccob → pccobplpag → pcplpag	Informações dos campos: APIs Integrações - Planos de Pagamentos
operadoras	pcoperadoracartao	Informações dos campos: APIs Integrações Winthor

Exemplo do envio da requisição:

URI

method: 'GET',
url: '/winthor/venda/v0/tipos-cobrancas'

Params

pagina: 1										- número da página
tamanho: 10										- quantidade por página
dataUltimaAlteracao: AAAA-MM-DDTHH:MM:SS		- data de ultima alteração
codfilial:										- código da filial
codigoCobranca:									- código de tipo de cobrança

{
    "first": false,
    "items": [
        {
            "id": "TK",
            "cobranca": "TICKET",
            "cartao": false,
            "boleto": false,
            "nivelvenda": 5,
            "tipoOperacaoTef": "C",
            "vencimentoCartao": 0,
            "tipoPagtoEcf": "T",
            "codBandeira": 0,
            "taxaJuros": 10,
            "prazoMaximoVenda": 0,
            "codMoeda": "D",
            "codCliente": 0,
            "codFilial": "99",
            "dataAtualizacao": "2022-07-19T15:52:02",
            "dataCadastro": "2022-07-19T15:52:02",
            "planoPagamentos": [
                {
                    "codigo": 12,
                    "descricao": "PAGAMENTO DIA FIXO",
                    "numColunaPreco": 1,
                    "formaParcelamento": "T",
                    "prazos": [
                        0,
                        0,
                        0,
                        0,
                        0,
                        0,
                        0,
                        0,
                        0,
                        0,
                        0,
                        0
                    ],
                    "codigoFilial": "99",
                    "tipoPrazo": {
                        "sigla": "N",
                        "descricao": "Normal"
                    },
                    "percentualAcrescimo": 0,
                    "prazoMedio": 0,
                    "descontarEntrada": false,
                    "tipoEntrada": {
                        "codigo": 1,
                        "descriçao": "Igual"
                    },
                    "vendaBk": true,
                    "tipoVenda": "VP",
                    "quantidadeMinimaPedido": 0,
                    "valorMinimoPedido": 0,
                    "ativo": true,
                    "numeroParcelas": 1,
                    "dataCriacao": "2022-07-19T14:37:59",
                    "dataUltimaAtualizacao": "2022-07-19T14:37:59",
                    "vendaVista": false
                }
            ],
            "operadoras": [ {
                    "codcob": "MDEB",
                    "operadora": "Outro Serviço",
                    "codfilial": "99",
                    "codigoOperadora": "40",
                    "codigoTef": "40",
                    "tipoOperacaoTef": {
                        "codTipoTef": "01",
                        "descricao": "Débito"
                    },
                    "ultimaAlteracao": "2022-07-19T15:52:02"
                }]
        }
    ],
    "hasNext": false
}

Apresentou Status Code 404 Not Found ao enviar a requisição

Caso obtenha o conteúdo abaixo ao enviar a requisição, verifique na rotina 812 do WTA se os serviços winthor-tributacao e winthor-produto estão instalados. Caso não esteja, acesse a rotina 801 do WTA e realize a instalação.

<html>
 
<head>
    <meta http-equiv="Content-Type" content="text/html;charset=utf-8" />
    <title>Error 404 Not Found</title>
</head>
 
<body>
    <h2>HTTP ERROR 404</h2>
    <p>Problem accessing /api/branch/v1/. Reason:
        <pre>    Not Found</pre>
    </p>
    <hr><a href="http://eclipse.org/jetty">Powered by Jetty:// 9.3.21.v20170918</a>
    <hr />
</body>
 
</html>

Instalei o serviço e apresentou Status Code 403 Forbidden ao enviar a requisição

Caso apresente 403 Forbidden, verifique se realizou a autenticação antes do envio da requisição.

{
    "code": "UNK-ERR",
    "message": "Erro de Requisição",
    "detailedMessage": "The current Subject is not authenticated.  Access denied.",
    "details": []
}

Instalei o serviço e não está retornando informações

Caso a lista retornada esteja vazia, verifique se os filtros que você informou estão coerentes com os registros de tipos de cobranças cadastrados e se há vinculo entre os planos, cobranças e operadoras

{
    "first": false,
    "items": [],
    "hasNext": false
}

Páginas filhas

APIs Integrações - Tipos de Cobranças - EM HOMOLOGAÇÃO

Objetivo

Pré-Requisitos e Restrições

Integração