Páginas filhas
  • APIs Integrações - Consulta Despacho Notas Fiscais - XML TOTVS OMNI

Versões comparadas

Chave

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

Objetivo

Este documento tem como objetivo explicar o funcionamento da integração das Notas Fiscais .(Integração exclusiva TOTVS OMNI)

Pré-Requisitos e Restrições

  • Necessário a instalação do serviço winthor-fiscal.
  • Necessário a instalação do serviço winthor-venda.
  • Necessário a instalação do serviço winthor-pedido-venda.
  • As informações do OMNI (Rotina 132) devem estar com os campos 4514 (Endereço do site da loja OMNI), 4516 (Senha do usuário da loja OMNI) e 4515 (Usuário da loja OMNI) parametrizados com suas respectivas informações.

Integração

Totvs custom tabs box
tabsEnvio Parâmetros, Resposta da Requisição, Possíveis falhas 
idspasso1,passo2,passo3

A integração consiste em consultar o XML da nota fiscal referente ao número do pedido e/ou da transação informados.

Totvs custom tabs box items
defaultno
referenciapasso1

Envio e resposta da requisição:

Bloco de código
languagejs
titleURI
method: 'GET',
url: '/winthor/venda/v0/pedido/orderDispatch/{ID TRANSAÇÃO}'   - Número da transação referente a nota fiscal a que se deseja consultar o xml.
Bloco de código
languagejs
titleHeader
Content-Type : application/json  
Totvs custom tabs box items
defaultno
referenciapasso2

Exemplo JSON da resposta:  

Bloco de código
languagejs
titleBody Response
{
    "token": "string"
    "statusId": 000,
    "orderNumber": "string",
    "invoiceNumber": "0000",
    "invoiceDateTime": "0000-00-00T00:00:00",
    "invoiceAmount": 00.00,
	"invoiceXML": "string"
	"invoiceKey": 0000
}
Totvs custom tabs box items
defaultno
referenciapasso3

Possíveis falhas:  

Bloco de código
languagejs
title1- Usuário ou senha incorretos ou sem permissão para acesso:
{

    "mensagem": "(WT-PV-000000) → Exceção inválida" 

}

Verificar informações de Login nos campos 4515 e 4516 da rotina 132, caso estejam corretas, verificar se este usuário possui permissão no OMNI.

...