Nesta rota é possível realizar toda a configuração, para que o Plug Storage busque as notas emitidas contra o CNPJ do cliente.
Hoje é possível realizar a busca de dois documentos, NF-e e CT-e.
POST
https://app.plugstorage.com.br/api/v2/destinadas/configdestined
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/form-data ou application/json |
Body
| Nome | Descrição | Obrigatório |
|---|---|---|
| cert_pfx | Arquivo .pfx | Não |
| cert_password | senha do certificado. | Não |
| dfe_cert_concentrating | Utiliza certificado digital da empresa concentradora (1 ou 0) | Sim |
| uf | Web Services. | Sim |
| dfe_period | Período que deve ser realizado a busca de destinadas. | Sim |
| dfe_tipo | Quais Documentos deseja buscar (NFe, CTe ou AMBOS) | Sim |
| dfe_notifica | Notifica sobre novas notas encontradas (1 ou 0) | Sim |
| Habilita a o manifesto automatico de CIÊNCIA DA OPERAÇÃO | Sim | |
| cnpj_cpf | CNPJ / CPF do cliente que gostaria de configurar a consulta. | Sim |
O preenchimento dos campos "cert_pfx" e "cert_password" não é obrigatório.
No entanto, eles devem ser informados sempre que você desejar utilizar um certificado digital próprio para a emissão ou consulta dos documentos fiscais.
Caso esses campos não sejam enviados, o sistema irá utilizar automaticamente o certificado da empresa concentradora, que é o certificado padrão configurado na plataforma.
Em resumo:
Não vai usar o certificado próprio? → Pode deixar os campos em branco.
Vai usar o seu certificado? → É obrigatório informar tanto o arquivo "
cert_pfx" quanto a senha "cert_password".
Caso o campo "dfe_cert_concentrating" esteja informando com 1, o Plug Storage utilizara o certificado da em empresa concentradora cadastrada, para realizar as buscas no Sefaz.
OBS: é necessário que já esteja configurado um certificado digital valido para a empresa concentradora.
No campo "uf" deve se informar o Web Services do estado que será buscado.
• AC
• AL
• AP
• AM
• BA
• CE
• DF
• ES
• GO
• MA
• MT
• MS
• MG
• PA
• PB
• PR
• PE
• PI
• RJ
• RN
• RS
• RO
• RR
• SC
• SP
• SE
• TO
No campo "dfe_period", deve ser informado o período em que será buscado as notas na Sefaz. Tendo as seguintes opções:
Não -> Não será realizado a busca de destinadas automaticamente.
1 -> É realizado a busca de destinadas a cada 1 hora.
2 -> É realizado a busca de destinadas a cada 2 hora.
4 -> É realizado a busca de destinadas a cada 4 hora.
8 -> É realizado a busca de destinadas a cada 8 hora.
12 -> É realizado a busca de destinadas a cada 12 hora.
24 -> É realizado a busca de destinadas a cada 24 hora.
No campo "dfe_tipo" é possível selecionar quais documentos serão buscados. Tendo as seguintes opções:
• NFE
• CTE
• AMBOS
No campo “dfe_cienciaAutomatica”, você define se o PlugStorage deve ou não realizar automaticamente o Manifesto de Ciência da Operação para as NF-e destinadas ao seu CNPJ.
Os valores possíveis são:
0 – Automação desativada
1 – Automação ativada
Tecnicamente, esse manifesto é um evento previsto pela SEFAZ que indica que o destinatário tomou conhecimento da existência da NF-e.
É importante destacar que a SEFAZ somente disponibiliza o XML completo da nota (com itens, valores e demais informações detalhadas) após a realização desse manifesto.
Caso o manifesto não seja realizado, a SEFAZ libera apenas o XML Resumo, que contém informações limitadas e não possibilita a visualização completa da operação.
Em outras palavras:
Ativar o campo (1) permite que o PlugStorage execute esse processo automaticamente, garantindo acesso ao XML completo sem necessidade de intervenções manuais.
Retorno
Exemplo de retorno:
{
"error": false,
"message": "Configuração realizada com sucesso, para o usuário: TecnoSpeed"
}
Exemplo de retorno com erro:
{
"error": true,
"message": "Parâmetro DFE_TIPO invalido ou não informado!"
}
Comentários
0 comentário
Por favor, entre para comentar.