Páginas filhas
  • APIs Integrações - Notas Fiscais - XML

Versões comparadas

Chave

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

...

Este documento tem como objetivo explicar o funcionamento da integração da Seção.

Pré-Requisitos e Restrições

...

das Notas Fiscais.

Integração


Totvs custom tabs box
tabsDados integrados com Winthor, Envio Parâmetros, Resposta da Requisição, Passo 04
idspasso1,passo2,passo3

A integração consiste em enviar todas as categorias que serão utilizados no E-Commerceo XML da nota fiscal referente ao número do pedido e/ou da transação informados.

Totvs custom tabs box items
defaultyes
referenciapasso1

Os dados integrados são: 

SECTIONS  INVOICEDOCUMENT                            |         PCSECAO PCDOCELETRONICO

API

Referência Winthor

departmentorderId

pcdeptopcpedc.codeptonumped

idtransactionId

pcsecaopcnfsaid.codsecnumtransvenda 

descriptioninvoiceXml

pcsecao.descricao

id

pcdepto.codepto

name

pcdepto.descricao

fatherCategoryId

pcdepto.coddeptoprinc

title

pcdepto.titulo

description

pcdepto.descricaoecommerce

keywords

pcpalavraschave.descricao

lastChange

pcdepto.dtultalter

updateStockGeneral

pcdepto.atualizainvgeral

typeMerchandise

pcdepto.tipomerc

dtcreate

pcdepto.dtcadastro

active

pcdepto.ativo

title

pcdepto.titulo

keywords

pchave.descricao

adWordsRemarketingCode

pcdepto.codadwords

lastChange

pcsecao.dtultalter

dtcreate

pcsecao.dtcadastro

pcdoceletronico .xmlnfe

Totvs custom tabs box items
defaultno
referenciapasso2

Exemplo do envio da requisição:

Bloco de código
languagejs
titleURI
method: 'GET',
url: '/apiwinthor/purchasesfiscal/v1/documentosfiscais/productSectionsnfe/invoiceDocument'
Bloco de código
languagejs
titleParams
orderorderId  		: lastChange			- ordenação
lastChange  : 1900-01-01T00:00:00	- dataInteger da última alteração
page		: 1						- número da página
pageSize	: 10					- quantidadeNúmero por página
Totvs custom tabs box items
defaultno
referenciapasso3

Exemplo JSON da resposta:  

Bloco de código
languagejs
titleBody Response
{
    "first": false,
    "items": [
        {
            "_expandables": [
do pedido referente a nota fiscal a que se deseja consultar o xml;
transactionId : Integer     - Número da transação referente a nota fiscal a que se "department"
deseja consultar o xml;
returnBase64  : Boolean		- "true" ou "false", refere-se a solicitar que o retorno esteja codificado no padrão "Base 64". Não é um parâmetro obrigatório e o padrão é "false";
Totvs custom tabs box items
defaultno
referenciapasso3

Exemplo JSON da resposta:  

Bloco de código
languagejs
titleBody Response
{
    "invoiceXml": "string"          ],
            "id": 0,
            "description": "string",
            "department": {
                "id": 9,
                "name": "string",
                "fatherCategoryId": 0,
                "title": "",
                "description": "",
                "keywords": "",
                "lastChange": "1900-01-01T00:00",
                "updateStockGeneral": true,
                "typeMerchandise": "string",
                "dtcreate": "1900-01-01T00:00",
                "active": false
            },
            "title": "",
            "keywords": "",
            "adWordsRemarketingCode": "",
            "lastChange": "2020-11-16T12:29:50",
            "dtcreate": "1900-01-01T00:00:00"
        } 
 ],
 "hasNext": true
}

Para que seja realizada uma nova integração atualizando um registro já integrado, o sistema verifica a data de última atualização do registro. Portanto, ao realizar alguma alteração no registro, ele será encaminhado novamente para a view para manter a integridade dos dados do ERP com o E-commerce

...