Como ter acesso aos documentos fiscais via API?

Sigua os passos descritos abaixo:

1-Instalação

Os serviços da Market devem ser instalados conforme este manual no linux do cliente, e as portas solicitadas devem ser liberadas. Caso quem for acessar esse serviço for uma empresa diferente da Market, não se esqueça de liberar o acesso também para o IP do seu servidor.

2-Usuário

O usuário que será utilizado é o mesmo do Market Gestor, sendo assim cadastre um novo usuário e dê a permissão indicada na imagem abaixo:

Após criar o usuário acesse o Gestor com essa nova conta e crie uma senha para o usuário.

3-Obtendo o Token de acesso

Com o usuário do Gestor criado, acesse o serviço usando o seguinte endereço:

http://[IP EXTERNO DO CLIENTE]:1080

Nesse endereço será possível observar toda a documentação da API, os dados que queremos está sobre o agrupamento chamado Fiscal. Mas para ter acesso a essas informações é necessário um Token, ele pode ser obtido no endpoint indicado na imagem abaixo:

Exemplo:

curl --location 'http://131.255.99.999:1080/autenticacao/login/nome' \
--header 'Content-Type: application/json' \
--data '{
  "login": "INTEGRADOR",
  "password": "999999"
}'

4-Acessando os documentos fiscais

Os endpoints indicados abaixo devem ser utilizados para consultar os documentos existentes e baixar o XML:

Para saber mais detalhes sobre as notas fiscais recebidas de terceiros, use o endpoint "v1/outrosdocumentos/c170/terceiros/{EntradaId}" passando o atributo "Id" obtido ao consultar as notas fiscais recebidas no endpoint "v1/outrosdocumentos".

Note que as informações dos itens da entrada se referem aos mesmos valores enviados no arquivo SPED c170, para mais detalhes consulte a documentação do SPED c170.


Para mais detalhes clique sobre o endpoint para consultar a documentação.

 


Gestor \ Fiscal

Escrito por Josué Diniz Lourenço e revisado por Josué Diniz Lourenço em 27/04/2024.


Link público: www.conhecimento.market.com.br/artigo/781