1 de 22

UnicoAuto

Introdução

Integração por API

Esta documentação tem por finalidade auxiliar a integração com a APIs do sistema unico auto.

As API do unico | auto utilizam uma arquitetura em REST e comunicação padrão em JSON. É possível encontrar mais detalhes, nos links a seguir, sobre os temas: REST e JSON.

O primeiro passo é adquirir uma conta de serviço e se autentica. Este item está detalhado a seguir, no tópico Get JWT.

A URL utilizada na documentação, são todas referentes ao ambiente de produção.

API

Autenticação

Antes de utilizar nossas APIs, você obrigatoriamente necessita se autenticar no sistema

Para a autenticação, utilizamos um padrão JWT, conforme explicitado na documentação abaixo:

Get JWT

O primeiro passo para utilizar todas as APIs subsequentes, é adquirir o JWT.

JWT (JSON Web Token) é um método RCT 7519 padrão da indústria para realizar autenticação entre duas partes por meio de um token assinado que autentica uma requisição web. Para saber mais, acesse: .

POST https://webservices.vianuvem.com.br/AdminVianuvem/public/token

Headers

Name

Type

Description

Request Body

Name

Type

Description

Exemplo de Requisição:

Importante: Para adquirir o JWT é necessário ter um usuário específico no sistema, criado para essa finalidade.

Caso possua acesso a gestão de usuários, você mesmo pode criar o usuário, caso não possua o acesso, basta solicitar a criação do usuário através do nosso suporte: suporte@vianuvem.com.br.

Processos

Aqui estão documentadas todas as nossas APIs públicas relacionadas aos processos

Iniciar processo BPM

O objetivo dessa API é automatizar o início dos processos no sistema a partir de uma requisição do tipo REST.

POST https://webservices.vianuvem.com.br/AdminVianuvem/api/process/create

Headers

Name

Type

Description

Request Body

Name

Type

Description

{
    "id": 58089890,
    "stageDocumentTypes": [
        {
            "documentTypeId": 70033766,
            "documentTypeName": "DOCUMENTO CAPTURADO VIA INTEGRAÇÃO",
            "icon": null,
            "required": false,
            "sequence": null,
            "slaTime": null,
            "indexers": [],
            "desired": false,
            "attachments": [],
            "devices": null,
            "hasForm": false,
            "exists": false,
            "flagDisabled": false,
            "flagRestrainCapture": false,
            "formPrintTemplate": [],
            "form": false
        }
    ],
    "flagSelfCapture": false
}

<html>
    <head>
        <title>Error</title>
    </head>
    <body>Internal Server Error</body>
</html>

// Erro no parâmetro "workflowId"
Tipo de Processo não encontrado para essa conta

// Erro no parâmetro "establishmentCNPJ"
Estabelecimento não encontrado

// Erro no parâmetro "initialTransition"
Esse estagio nao e uma situacao

// Erro no parâmetro "indexers"
Indexador obrigatorio não recebido ou indexador recebido [null] não encontrado na configuração deste tipo de processo []

Exemplo de Requisição:

{
	"workflowId": 5002995,
	"establishmentCNPJ": "73386365000",
	"observation":"",
	"isIntegration":"true",
    	"initialTransition": ["PRIMEIRA TRANSIÇÃO"],
	"indexers":
		[
			{
				"sequence":1,
				"indexerLabel":"INTEIRO",
				"indexerValue":"666",
				"indexerType":"I"
			},
			{
				"sequence":2,
				"indexerLabel":"TEXTO",
				"indexerValue":"NOME DO FULANO",
				"indexerType":"S"
			},
			{
				"sequence":3,
				"indexerLabel":"DATA",
				"indexerValue":"07/12/2021",
				"indexerType":"D"
			},
			{
				"sequence":4,
				"indexerLabel":"VALOR",
				"indexerValue":"1.000,00",
				"indexerType":"V"
			}
		]
}

Importante: Os parâmetros que são passados na requisição podem ser adquiridos através da abertura de um chamado com o nosso suporte: suporte@vianuvem.com.br.

Consultar processos

O objetivo dessa API é realizar a consulta de processos no sistema a partir de um requisição do tipo REST.

POST https://webservices.vianuvem.com.br/AdminVianuvem/api/process/search

Headers

Name

Type

Description

Request Body

Name

Type

Description

Exemplo de Requisição:

Inserir documentos em processo

O objetivo dessa API é rinserir documentos em um processo no sistema a partir de um requisição do tipo REST.

POST https://webservices.vianuvem.com.br/AdminVianuvem/api/process/document

Headers

Name

Type

Description

Request Body

Name

Type

Description

Exemplo de Requisição:

Importante: Os parâmetros que são passados na requisição podem ser adquiridos através do nosso suporte: suporte@vianuvem.com.br.

Mudar situação de processo

O objetivo dessa API é mudar a situação de um processo no sistema a partir de uma requisição do tipo REST.

POST https://webservices.vianuvem.com.br/AdminVianuvem/api/process/changeSituation

Headers

Name

Type

Description

Request Body

Name

Type

Description

Exemplo de Requisição:

Importante: Os parâmetros que são passados na requisição podem ser adquiridos através do nosso suporte: suporte@vianuvem.com.br.

Inserir comentários em processo

O objetivo dessa API é inserir comentários em um processo no sistema a partir de uma requisição do tipo REST

POST https://webservices.vianuvem.com.br/AdminVianuvem/api/process/comments

Headers

Name

Type

Description

Request Body

Name

Type

Description

Exemplo de Requisição:

Alterar indexadores de um processo

POST https://webservices.vianuvem.com.br/AdminVianuvem/api/v1/processes/indexers?values=666

PS: No próprio endpoint, após os "values=", você deverá passar os indexadores do processo que deseja alterar os indexadores, separados por vírgula (ex: 666,NOME%DO%FULANO) - percebe-se que se substitui o "espaço" pelo sinal de porcentagem "%"

Headers

Name

Type

Description

Request Body

Name

Type

Description

{
    "data": {
        "id": 58089890
    },
    "errors": []
}

{
    "data": [],
    "errors": [
        {
            "message": "\"Nenhum processo encontrado\""
        }
    ]
}

{
    "data": [],
    "errors": [
        {
            "message": "\"Mais de um processo encontrado\""
        }
    ]
}

<html>
    <head>
        <title>Error</title>
    </head>
    <body>Internal Server Error</body>
</html>

Exemplo de Requisição:

{
     "indexers": [
     {
          "label": "DATA",
          "value": "10/10/2010"
     },
     {
          "label": "VALOR",
          "value": "2.000,00"
     }
     ]
}

Fluxo de pagamentos

Aqui estão documentadas todas as nossas APIs públicas relacionadas ao fluxo de pagamentos

Lançar um documento no fluxo de pagamentos

O objetivo dessa API é automatizar o lançamentos de documentos do fluxo de pagamentos no sistema a partir de uma requisição do tipo REST.

POST https://webservices.vianuvem.com.br/AdminVianuvem/api/document/capture

Headers

Name

Type

Description

Request Body

Name

Type

Description

{
    "documents": [
        {
            "documentId": 27923418,
            "createDate": "2021-11-03T13:27:33.907-03:00",
            "status": false,
            "currentVersion": 1,
            "documentTypeId": 700766,
            "accountId": 50182,
            "documentObjects": [
                {
                    "documentObjectId": 279234187,
                    "storageLocal": "d2f7c1a59169ec3dbdec6906da780246/5d15ea7da65c52521253202.original.pdf",
                    "objectSize": null,
                    "objectTypeId": 70033766,
                    "createDate": "2021-11-03T13:27:33.907-03:00",
                    "fullSignedPath": "https://cdn.vianuvem.com.br/d2f7c1a59153e5d/1b1aa6c0f50980c23d2a7c285d9aef68.original.pdf?Expires=1636316855&Signature=r19g4ux329mgv2uUIbea6je01RYSIG4ULH2FkbKH3R60WV0yuW~YU7d0B4PCbIWs51Y-d5TbGoFtQoja641xg5E613WLl7BKBsMZI3IrlZnsqduLu4wi~QchAwoKC9wZjTLMysMeLr5oZoQMkQs1x7wFyve-LfuCCUeJmxg2pbLomSlHMn7NUbf~eqUTimaQvh7sQjgWQ9pOvgTovFbYo7N0fBcQz1jxOwFf4PBovG7lB9Fx~bVuI5Pu4pUlwTlC99GthaAgMw43CjS-DqRKYP~ZWQALjEre3i2rQe5BYovZk3QGHnJfwM0AhkvOSw053lAf6x~g5gWAV~jjfJn6mg__&Key-Pair-Id=APKAJB5L4ASFURY6CXTA"
                }
            ],
            "workflowInstanceId": null
        }
    ],
    "transitionsTree": []
}

// Erro na propriedade "workflowId"
Tipo de processo não encontrado	  --  process.getIdProcessType(): null  --  captureDomain.getWorkflowId(): 5002995

// Erro na propriedade "documentTypeId"
Tipo de documento não encontrado para essa conta

// Erro na propriedade "indexers"
Indexador obrigatorio não recebido ou indexador recebido [INTEI] não encontrado na configuração deste tipo de processo [50.029.958]

<html>
    <head>
        <title>Error</title>
    </head>
    <body>Internal Server Error</body>
</html>

Exemplo de requisição:

{ 
	"workflowId": 50029958,
	"establishmentCNPJ": 73386365000170,
	"documentVOList": 
	[ 
		{ 
			"documentTypeId": 70033766,
			"documentObjects": 
			[ 
				{ 
					"attachments": [],
					"indexers": 
					[
						{
							"sequence":1, 
							"indexerTypeName":"INTEIRO", 
							"indexerValue":"1234", 
							"indexerType":"I" 
						},
                        {
							"sequence":2, 
							"indexerTypeName":"TEXTO", 
							"indexerValue":"TESTE", 
							"indexerType":"S" 
						}
					],
					"name":"pdf.pdf",
					"objectSize":0,
					"observation":"Inserido via integração",
					"objectTypeId":2,
					"documentObjectAsBase64":
						"JVBERi0xLZjN1BO7q9Rgo..."
			}
		]
	}
]
}

Consultar documentos

O objetivo dessa API é realizar a consulta de documentos no sistema a partir de um requisição do tipo REST.

POST https://webservices.vianuvem.com.br/AdminVianuvem/api/document/search

Headers

Name

Type

Description

Request Body

Name

Type

Description

Exemplo de Requisição:

Consulta XML

O objetivo dessa API é realizar a consulta de XMLs no sistema a partir de um requisição do tipo REST.

POST https://webservices.vianuvem.com.br/AdminVianuvem/api/integration/nfe/xml

Headers

Name

Type

Description

Request Body

Name

Type

Description

<nfeProc versao="4.00" xmlns="http://www.portalfiscal.inf.br/nfe">
    <NFe xmlns="http://www.portalfiscal.inf.br/nfe">
        <infNFe versao="4.00" Id="NFe35191104952112000101550010001641221565130774">
            <ide>
                <cUF>35</cUF>
                <cNF>56513077</cNF>
                <natOp>DEV. MERCADORIAS SUBST.TRIB. (PECAS)</natOp>
                <mod>55</mod>
                <serie>1</serie>
                <nNF>164122</nNF>
                <dhEmi>2019-11-14T15:23:00-03:00</dhEmi>
                <tpNF>0</tpNF>
                <idDest>1</idDest>
                <cMunFG>3550308</cMunFG>
                <tpImp>1</tpImp>
                <tpEmis>1</tpEmis>
                <cDV>4</cDV>
                <tpAmb>1</tpAmb>
                <finNFe>4</finNFe>
                <indFinal>1</indFinal>
                <indPres>1</indPres>
                <procEmi>0</procEmi>
                <verProc>NBS 01.013</verProc>
                <NFref>
                    <refNFe>35191104952112000101550010001633261565130770</refNFe>
                </NFref>
            </ide>
            <emit>
                <CNPJ>04952112000101</CNPJ>
                <xNome>Calmotors Ltda</xNome>
                <xFant>Calmotors</xFant>
                <enderEmit>
                    <xLgr>PACAEMBU</xLgr>
                    <nro>343</nro>
                    <xBairro>Barra Funda</xBairro>
                    <cMun>3550308</cMun>
                    <xMun>SAO PAULO</xMun>
                    <UF>SP</UF>
                    <CEP>01155000</CEP>
                    <cPais>1058</cPais>
                    <xPais>BRASIL</xPais>
                    <fone>1136655500</fone>
                </enderEmit>
                <IE>110147097118</IE>
                <IM>31350712</IM>
                <CNAE>4511101</CNAE>
                <CRT>3</CRT>
            </emit>
            <dest>
                <CNPJ>00434116002697</CNPJ>
                <xNome>MAIS DISTRIBUIDORA </xNome>
                <enderDest>
                    <xLgr>VERGUEIRO</xLgr>
                    <nro>4911</nro>
                    <xBairro>VILA MARIANA</xBairro>
                    <cMun>3550308</cMun>
                    <xMun>SAO PAULO</xMun>
                    <UF>SP</UF>
                    <CEP>04101300</CEP>
                    <cPais>1058</cPais>
                    <xPais>BRASIL</xPais>
                    <fone>1150893000</fone>
                </enderDest>
                <indIEDest>1</indIEDest>
                <IE>144800095116</IE>
                <email>1@2.com.br</email>
            </dest>
            <det nItem="1">
                <prod>
                    <cProd>K05033307AD</cProd>
                    <cEAN>SEM GTIN</cEAN>
                    <xProd>SENSOR POSICAO</xProd>
                    <NCM>87081000</NCM>
                    <CEST>0000000</CEST>
                    <indEscala>S</indEscala>
                    <CFOP>1411</CFOP>
                    <uCom>UN</uCom>
                    <qCom>1.0000</qCom>
                    <vUnCom>255.9000000000</vUnCom>
                    <vProd>255.90</vProd>
                    <cEANTrib>SEM GTIN</cEANTrib>
                    <uTrib>UN</uTrib>
                    <qTrib>1.0000</qTrib>
                    <vUnTrib>255.9000000000</vUnTrib>
                    <vDesc>75.90</vDesc>
                    <indTot>1</indTot>
                </prod>
                <imposto>
                    <ICMS>
                        <ICMS60>
                            <orig>0</orig>
                            <CST>60</CST>
                            <vBCSTRet>0.00</vBCSTRet>
                            <pST>0.0000</pST>
                            <vICMSSubstituto>0</vICMSSubstituto>
                            <vICMSSTRet>0.00</vICMSSTRet>
                            <pRedBCEfet>0.0000</pRedBCEfet>
                            <vBCEfet>180.00</vBCEfet>
                            <pICMSEfet>18.0000</pICMSEfet>
                            <vICMSEfet>32.40</vICMSEfet>
                        </ICMS60>
                    </ICMS>
                    <PIS>
                        <PISOutr>
                            <CST>99</CST>
                            <vBC>180.00</vBC>
                            <pPIS>0.0000</pPIS>
                            <vPIS>0.00</vPIS>
                        </PISOutr>
                    </PIS>
                    <COFINS>
                        <COFINSOutr>
                            <CST>99</CST>
                            <vBC>180.00</vBC>
                            <pCOFINS>0.0000</pCOFINS>
                            <vCOFINS>0.00</vCOFINS>
                        </COFINSOutr>
                    </COFINS>
                </imposto>
            </det>
            <total>
                <ICMSTot>
                    <vBC>0.00</vBC>
                    <vICMS>0.00</vICMS>
                    <vICMSDeson>0.00</vICMSDeson>
                    <vFCP>0.00</vFCP>
                    <vBCST>0.00</vBCST>
                    <vST>0.00</vST>
                    <vFCPST>0.00</vFCPST>
                    <vFCPSTRet>0.00</vFCPSTRet>
                    <vProd>255.90</vProd>
                    <vFrete>0.00</vFrete>
                    <vSeg>0.00</vSeg>
                    <vDesc>75.90</vDesc>
                    <vII>0.00</vII>
                    <vIPI>0.00</vIPI>
                    <vIPIDevol>0.00</vIPIDevol>
                    <vPIS>0.00</vPIS>
                    <vCOFINS>0.00</vCOFINS>
                    <vOutro>0.00</vOutro>
                    <vNF>180.00</vNF>
                </ICMSTot>
            </total>
            <transp>
                <modFrete>9</modFrete>
            </transp>
            <pag>
                <detPag>
                    <tPag>90</tPag>
                    <vPag>0.00</vPag>
                </detPag>
            </pag>
            <infAdic>
                <infCpl>Devolucao Total da nota : 163326 /5</infCpl>
            </infAdic>
            <infRespTec>
                <CNPJ>02348447000181</CNPJ>
                <xContato>GERSON DA COSTA TEIXEIRA</xContato>
                <email>gerson@nbsi.com.br</email>
                <fone>6521284300</fone>
            </infRespTec>
        </infNFe>
        <Signature xmlns="http://www.w3.org/2000/09/xmldsig#">
            <SignedInfo>
                <CanonicalizationMethod Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315" />
                <SignatureMethod Algorithm="http://www.w3.org/2000/09/xmldsig#rsa-sha1" />
                <Reference URI="#NFe35191104952112000101550010001641221565130774">
                    <Transforms>
                        <Transform Algorithm="http://www.w3.org/2000/09/xmldsig#enveloped-signature" />
                        <Transform Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315" />
                    </Transforms>
                    <DigestMethod Algorithm="http://www.w3.org/2000/09/xmldsig#sha1" />
                    <DigestValue>WH7rPDLM73qwXpK6vXGYjscNlPc=</DigestValue>
                </Reference>
            </SignedInfo>
            <SignatureValue>AOUcYOnd0vasSjKSDUCumaoTEqBmTzrIRL5X/garDXN+A8iHNZTinZeoCR3ipAUIVXiLfos8XyJXuUNTrTFZ76dbpPnFwKJHkAdrKVR3T0fz8NOcpNC7flOW71IKq9ioQa4a9Qp+tmY7C1HGzlRC3t3TYP+n0TID69VBOPKIk9+wqHWYUkai3iG5Tb4rn9NyyeOJOtKL0AeFxrM0Uym42QmmIAwrjQUjg30K3otNeWUaLnggo9MKkZf3Fit97dLLd9seqEBiyeVcj/5JXTQAC6TVnH0Gqwoo0RCEejSxa/VH04LYbrCCi2ZxkCfaKevx34rZbe+WjZ19bGA8yfFTYw==</SignatureValue>
            <KeyInfo>
                <X509Data>
                    <X509Certificate>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</X509Certificate>
                </X509Data>
            </KeyInfo>
        </Signature>
    </NFe>
    <protNFe versao="4.00">
        <infProt Id="Id135190852795161">
            <tpAmb>1</tpAmb>
            <verAplic>SP_NFE_PL009_V4</verAplic>
            <chNFe>35191104952112000101550010001641221565130774</chNFe>
            <dhRecbto>2019-11-14T15:23:14-03:00</dhRecbto>
            <nProt>135190852795161</nProt>
            <digVal>WH7rPDLM73qwXpK6vXGYjscNlPc=</digVal>
            <cStat>100</cStat>
            <xMotivo>Autorizado o uso da NF-e</xMotivo>
        </infProt>
    </protNFe>
</nfeProc>

Documento não encontrado

<html>
    <head>
        <title>Error</title>
    </head>
    <body>Internal Server Error</body>
</html>

Exemplo de Requisição:

{
	"cnpjNumber":"04952112000101", 
	"nfeNumber":"000164122"
}

Relatórios

Aqui estão documentadas todas as nossas APIs públicas relacionadas aos relatórios

Get Report (obter relatórios)

O objetivo dessa API é obter um relatório personalizado no sistema a partir de um requisição do tipo REST.

GET https://vn.vianuvem.com.br/reports/api/report/schedulerReports/{ID relatório}/last

No "{ID relatório}" você deverá inserir o ID do relatório no sistema.

Headers

Name

Type

Description

{
    "id": 12451,
    "date": "29/10/2021 13:04:54",
    "storageLocal": "https://cdn.vianuvem.com.br/reports/scheduler_report/PkATkFFg7QVaRzL6jxOg.xlsx?Expires=1636318327&Signature=p4KAwm3HU6VzVQOAQQ8Q1LvTuh8NduAZmQrRh6fuKz2bh-UpXsG6-zC0ZABo9mJxAVZzV~uFmDQ4UxJKpz5kw88IS0GqEjnwFr~OZn92NmJu1Qany33NVEkuMz4U-IKarhqUlkJDGEYIurhQ6YNURRBaGkrBoEZRK7jI722xmpLzVj696znMz-RZRNBKWwdKNcgo37u~ydf2OATlo7zx25KHxWD4s8InECZn5z-V5BwD9PGPddClptQ5UUNBxgq4ABlDNXMATiIqZkT727NOiUXMHQHZOk1r74dnj4jX7HgWmXyv~bVq5SBXxToYSVHxHU5jqIeKWak2GZJcPHARLw__&Key-Pair-Id=APKAJB5L4ASFURY6CXTA"
}

<html>
    <head>
        <title>Error</title>
    </head>
    <body>Internal Server Error</body>
</html>

Relatorio nao encontrado

Importante: Através dessa API, você irá obter o último relatório gerado. Para uma melhor performance, sugerimos que solicite que seja cadastrado um agendamento no relatório, para que este esteja sempre atualizado.

A configuração de agendamento e o ID do relatório podem ser obtidos através da abertura de um chamado com o nosso suporte: suporte@vianuvem.com.br.

Gestão de usuários

Aqui estão documentadas todas as nossas APIs públicas relacionadas à gestão de usuários

Criar usuário

O objetivo dessa API é automatizar a criação de usuários no sistema a partir de uma requisição do tipo REST.

POST https://webservices.vianuvem.com.br/AdminVianuvem/api/users/create

Headers

Name

Type

Description

Request Body

Name

Type

Description

Exemplo de Requisição:

Consultar usuário

O objetivo dessa API é automatizar a consulta de usuários no sistema a partir de uma requisição do tipo REST.

GET https://webservices.vianuvem.com.br/AdminVianuvem/api/users/byCPF/{cpf}

Um “route parameter” é enviado com o CPF do usuário a ser consultado.

Headers

Name

Type

Description

Desativar usuário

O objetivo dessa API é automatizar a desativação de usuários no sistema a partir de uma requisição do tipo REST.

DELETE https://webservices.vianuvem.com.br/AdminVianuvem/api/users/{login}/byLogin

Um “route parameter” é enviado com o nome do usuário a ser desativado.

Headers

Name

Type

Description

Ativar usuário

O objetivo dessa API é automatizar a ativação de usuários no sistema a partir de uma requisição do tipo REST.

PUT https://webservices.vianuvem.com.br/AdminVianuvem/api/users{login)/byLogin

Um “route parameter” é enviado com o nome do usuário a ser ativado.

Headers

Name

Type

Description

Consulta XML

O objetivo dessa API é realizar a consulta de XMLs no sistema a partir de um requisição do tipo REST.

POST https://webservices.vianuvem.com.br/AdminVianuvem/api/integration/nfe/xml

Headers

Name

Type

Description

Request Body

Name

Type

Description

<nfeProc versao="4.00" xmlns="http://www.portalfiscal.inf.br/nfe">
    <NFe xmlns="http://www.portalfiscal.inf.br/nfe">
        <infNFe versao="4.00" Id="NFe35191104952112000101550010001641221565130774">
            <ide>
                <cUF>35</cUF>
                <cNF>56513077</cNF>
                <natOp>DEV. MERCADORIAS SUBST.TRIB. (PECAS)</natOp>
                <mod>55</mod>
                <serie>1</serie>
                <nNF>164122</nNF>
                <dhEmi>2019-11-14T15:23:00-03:00</dhEmi>
                <tpNF>0</tpNF>
                <idDest>1</idDest>
                <cMunFG>3550308</cMunFG>
                <tpImp>1</tpImp>
                <tpEmis>1</tpEmis>
                <cDV>4</cDV>
                <tpAmb>1</tpAmb>
                <finNFe>4</finNFe>
                <indFinal>1</indFinal>
                <indPres>1</indPres>
                <procEmi>0</procEmi>
                <verProc>NBS 01.013</verProc>
                <NFref>
                    <refNFe>35191104952112000101550010001633261565130770</refNFe>
                </NFref>
            </ide>
            <emit>
                <CNPJ>04952112000101</CNPJ>
                <xNome>Calmotors Ltda</xNome>
                <xFant>Calmotors</xFant>
                <enderEmit>
                    <xLgr>PACAEMBU</xLgr>
                    <nro>343</nro>
                    <xBairro>Barra Funda</xBairro>
                    <cMun>3550308</cMun>
                    <xMun>SAO PAULO</xMun>
                    <UF>SP</UF>
                    <CEP>01155000</CEP>
                    <cPais>1058</cPais>
                    <xPais>BRASIL</xPais>
                    <fone>1136655500</fone>
                </enderEmit>
                <IE>110147097118</IE>
                <IM>31350712</IM>
                <CNAE>4511101</CNAE>
                <CRT>3</CRT>
            </emit>
            <dest>
                <CNPJ>00434116002697</CNPJ>
                <xNome>MAIS DISTRIBUIDORA </xNome>
                <enderDest>
                    <xLgr>VERGUEIRO</xLgr>
                    <nro>4911</nro>
                    <xBairro>VILA MARIANA</xBairro>
                    <cMun>3550308</cMun>
                    <xMun>SAO PAULO</xMun>
                    <UF>SP</UF>
                    <CEP>04101300</CEP>
                    <cPais>1058</cPais>
                    <xPais>BRASIL</xPais>
                    <fone>1150893000</fone>
                </enderDest>
                <indIEDest>1</indIEDest>
                <IE>144800095116</IE>
                <email>1@2.com.br</email>
            </dest>
            <det nItem="1">
                <prod>
                    <cProd>K05033307AD</cProd>
                    <cEAN>SEM GTIN</cEAN>
                    <xProd>SENSOR POSICAO</xProd>
                    <NCM>87081000</NCM>
                    <CEST>0000000</CEST>
                    <indEscala>S</indEscala>
                    <CFOP>1411</CFOP>
                    <uCom>UN</uCom>
                    <qCom>1.0000</qCom>
                    <vUnCom>255.9000000000</vUnCom>
                    <vProd>255.90</vProd>
                    <cEANTrib>SEM GTIN</cEANTrib>
                    <uTrib>UN</uTrib>
                    <qTrib>1.0000</qTrib>
                    <vUnTrib>255.9000000000</vUnTrib>
                    <vDesc>75.90</vDesc>
                    <indTot>1</indTot>
                </prod>
                <imposto>
                    <ICMS>
                        <ICMS60>
                            <orig>0</orig>
                            <CST>60</CST>
                            <vBCSTRet>0.00</vBCSTRet>
                            <pST>0.0000</pST>
                            <vICMSSubstituto>0</vICMSSubstituto>
                            <vICMSSTRet>0.00</vICMSSTRet>
                            <pRedBCEfet>0.0000</pRedBCEfet>
                            <vBCEfet>180.00</vBCEfet>
                            <pICMSEfet>18.0000</pICMSEfet>
                            <vICMSEfet>32.40</vICMSEfet>
                        </ICMS60>
                    </ICMS>
                    <PIS>
                        <PISOutr>
                            <CST>99</CST>
                            <vBC>180.00</vBC>
                            <pPIS>0.0000</pPIS>
                            <vPIS>0.00</vPIS>
                        </PISOutr>
                    </PIS>
                    <COFINS>
                        <COFINSOutr>
                            <CST>99</CST>
                            <vBC>180.00</vBC>
                            <pCOFINS>0.0000</pCOFINS>
                            <vCOFINS>0.00</vCOFINS>
                        </COFINSOutr>
                    </COFINS>
                </imposto>
            </det>
            <total>
                <ICMSTot>
                    <vBC>0.00</vBC>
                    <vICMS>0.00</vICMS>
                    <vICMSDeson>0.00</vICMSDeson>
                    <vFCP>0.00</vFCP>
                    <vBCST>0.00</vBCST>
                    <vST>0.00</vST>
                    <vFCPST>0.00</vFCPST>
                    <vFCPSTRet>0.00</vFCPSTRet>
                    <vProd>255.90</vProd>
                    <vFrete>0.00</vFrete>
                    <vSeg>0.00</vSeg>
                    <vDesc>75.90</vDesc>
                    <vII>0.00</vII>
                    <vIPI>0.00</vIPI>
                    <vIPIDevol>0.00</vIPIDevol>
                    <vPIS>0.00</vPIS>
                    <vCOFINS>0.00</vCOFINS>
                    <vOutro>0.00</vOutro>
                    <vNF>180.00</vNF>
                </ICMSTot>
            </total>
            <transp>
                <modFrete>9</modFrete>
            </transp>
            <pag>
                <detPag>
                    <tPag>90</tPag>
                    <vPag>0.00</vPag>
                </detPag>
            </pag>
            <infAdic>
                <infCpl>Devolucao Total da nota : 163326 /5</infCpl>
            </infAdic>
            <infRespTec>
                <CNPJ>02348447000181</CNPJ>
                <xContato>GERSON DA COSTA TEIXEIRA</xContato>
                <email>gerson@nbsi.com.br</email>
                <fone>6521284300</fone>
            </infRespTec>
        </infNFe>
        <Signature xmlns="http://www.w3.org/2000/09/xmldsig#">
            <SignedInfo>
                <CanonicalizationMethod Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315" />
                <SignatureMethod Algorithm="http://www.w3.org/2000/09/xmldsig#rsa-sha1" />
                <Reference URI="#NFe35191104952112000101550010001641221565130774">
                    <Transforms>
                        <Transform Algorithm="http://www.w3.org/2000/09/xmldsig#enveloped-signature" />
                        <Transform Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315" />
                    </Transforms>
                    <DigestMethod Algorithm="http://www.w3.org/2000/09/xmldsig#sha1" />
                    <DigestValue>WH7rPDLM73qwXpK6vXGYjscNlPc=</DigestValue>
                </Reference>
            </SignedInfo>
            <SignatureValue>AOUcYOnd0vasSjKSDUCumaoTEqBmTzrIRL5X/garDXN+A8iHNZTinZeoCR3ipAUIVXiLfos8XyJXuUNTrTFZ76dbpPnFwKJHkAdrKVR3T0fz8NOcpNC7flOW71IKq9ioQa4a9Qp+tmY7C1HGzlRC3t3TYP+n0TID69VBOPKIk9+wqHWYUkai3iG5Tb4rn9NyyeOJOtKL0AeFxrM0Uym42QmmIAwrjQUjg30K3otNeWUaLnggo9MKkZf3Fit97dLLd9seqEBiyeVcj/5JXTQAC6TVnH0Gqwoo0RCEejSxa/VH04LYbrCCi2ZxkCfaKevx34rZbe+WjZ19bGA8yfFTYw==</SignatureValue>
            <KeyInfo>
                <X509Data>
                    <X509Certificate>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</X509Certificate>
                </X509Data>
            </KeyInfo>
        </Signature>
    </NFe>
    <protNFe versao="4.00">
        <infProt Id="Id135190852795161">
            <tpAmb>1</tpAmb>
            <verAplic>SP_NFE_PL009_V4</verAplic>
            <chNFe>35191104952112000101550010001641221565130774</chNFe>
            <dhRecbto>2019-11-14T15:23:14-03:00</dhRecbto>
            <nProt>135190852795161</nProt>
            <digVal>WH7rPDLM73qwXpK6vXGYjscNlPc=</digVal>
            <cStat>100</cStat>
            <xMotivo>Autorizado o uso da NF-e</xMotivo>
        </infProt>
    </protNFe>
</nfeProc>

Documento não encontrado

<html>
    <head>
        <title>Error</title>
    </head>
    <body>Internal Server Error</body>
</html>

Exemplo de Requisição:

{
	"cnpjNumber":"04952112000101", 
	"nfeNumber":"000164122"
}