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 |
|---|
| tabs | Envio Parâmetros, Resposta da Requisição, Possíveis falhas |
|---|
| ids | passo1,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 |
|---|
| default | no |
|---|
| referencia | passo1 |
|---|
| Envio e resposta da requisição: | Bloco de código |
|---|
| 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 |
|---|
| Content-Type : application/json |
|
| Totvs custom tabs box items |
|---|
| default | no |
|---|
| referencia | passo2 |
|---|
| Exemplo JSON da resposta: | Bloco de código |
|---|
| language | js |
|---|
| title | Body 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 |
|---|
| default | no |
|---|
| referencia | passo3 |
|---|
| Possíveis falhas: | Bloco de código |
|---|
| language | js |
|---|
| title | 1- 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. |
|
...
