Documentação API - Vetor Zero/ GGP

Instruções de acesso aos pagamentos


Para acessar o endpoint GET dos pagamentos, é necessário seguir as seguintes instruções:
  • É obrigatório informar a key da API na URL

  • É obrigatório informar a data inicial e final seguindo o formato dd-mm-aaaa

  • Um exemplo de URL final para o request é:

https://intranet.vetorzero.com.br/api.get.notas_fiscais?key=numero_da_key&inicio=24-06-2019&fim=27-06-2019

Instruções de acesso às notas não conciliadas


Para acessar o endpoint GET das notas não conciliadas, é necessário seguir as seguintes instruções:

  • É obrigatório informar a key da API na URL

  • Este endpoint suporta até 3 filtros sendo eles: cnpj_prestador, numero_nota, inicio e fim (data)

  • Pelo menos um dos filtros supracitados é obrigatório, caso informe a data, os parâmetros inicio e fim são obrigatórios

  • A data segue o formato dd-mm-aaaa e o cnpj_prestador é formado apenas pelos números.

  • Um exemplo de URL final, utilizando todos os parâmetros, para o request é:

https://intranet.vetorzero.com.br/api.get.notas?key=numero_da_key&inicio=22-02-2018&fim=25-02-2018&cnpj_prestador=34656346345634&numero_nota=12314

Instruções para o envio de notas


Para acessar o endpoint POST das notas, é necessário seguir as seguintes instruções:

  • É obrigatório informar a key da API na URL

  • Deve-se seguir o seguinte modelo no corpo da requisição:

{
     “notas”: [
          {
               “id_ggp”: 522,
               “numero_nota”: 12345,
               “codigo_verificacao”: “1jd815n0v”,
               “cnpj_prestador”: “31449506000106”,
               “cnpj_tomador”: “31449503450106”,
               “valor_nota”: 5000.8,
               “discriminacao”: “”,
               “data_emissao”: “03/11/1992”,
               “serie_nota”: “”,
               “numero_rps”: “”,
               “serie_rps”: “”,
               “data_rps”: “”,
               “codigo_servico”: “16”,
               “tipo_lancamento”: “NFTS”,
               “data_prestacao”: “22/02/2018”,
               “numero_ntfs”: “315244”,
               “nome_prestador”: “Nome”,
               “nome_tomador”: “Nome”,
               “status”: “”
          }
     ]
}

  • Obs: Os CNPJs devem ser cadastrados apenas com números e o campo status pode assumir os valores de “normal” ou “cancelada”

  • A verificação de notas repetidas é feita a partir da avaliação da data de emissão, número da nota, valor e CNPJ do prestador.

  • Um exemplo de URL final para o request é:

https://intranet.vetorzero.com.br/api.post.notas_fiscais?key=numero_da_key

1 curtida