Foi disponibilizado uma nova rota para a API do Plug Storage, Nesta rota é possível solicitar a exportação de notas que se encontra na plataforma.
Ao realizar a requisição informando o período a ser exportado, modelo de documento, ambiente e o tipo de transação, será retornado um número de protocolo. Esse número deve ser informado na requisição para a rota de buscar o resultado da exportação, onde deve ser retornado os links para downloads do relatório em formato PDF e o arquivo compactado contendo os arquivos XML.
POST
https://app.plugstorage.com.br/api/v2/accountant/processexport
Headers
Nome | Valor | Descrição |
Authorization | Basic encode64(TokenSH:senha) | Token de identificação da sua Software House : Senha do usuário da Software House |
Content-Type | application/x-www-form-urlencoded ou application/json |
Body
Nome | Descrição | Obrigatório |
initial_period | Período Inicial, exe: 01-03-2020 | Sim |
final_period | Período final, exe: 31-03-2020 | Sim |
cnpj_cpf | CPF ou CNPJ da Exportação | Sim |
document_model | Modelo do Documento, exe: 55 | Sim |
environment | Ambiente, exe: 1 | Sim |
transaction | Tipo de Transação, exe: received | Não |
accountant_email | e-mail do contador para validar vinculação ao cliente | Não |
Valores aceitos para o campo document_model:
- 55 para NF-e,
- 65 para NFC-e,
- 59 para SAT,
- 57 para CT-e.
- 67 para CT-e OS.
- 99 para NFS-e.
Valores aceitos para o campo enviroment:
- 1 para ambiente de produção
- 2 para o ambiente de homologação.
Valores aceito para o campo transaction:
- "send": Será exportado documentos que o cliente é o EMISSOR.
- "received": Será exportados documentos que o cliente é o DESTINATÁRIO
- "other": Será exportados documentos que não seja do emitente e nem do destinatário.
para exportar todos os documento, NÃO informar o parâmetro transaction.
Retorno
Exemplo de retorno com sucesso:
{
"message": "Está sendo realizado a exportação das notas para o usuário TecnoSpeed. Segue o numero de protocolo para realizar a consulta.",
"protocol": "8308202003305776070"
}
Exemplo de retorno com erro:
{
"error": true,
"message": "Parâmetro document_model não informado ou Inválido!"
}
Comentários
0 comentário
Por favor, entre para comentar.