Lembre-se de acessar a central de ajudas através do seu sistema e-Login para ter acesso completo ao conteúdo.

[XML Protegido] Repositório NFe Emitidas Outro Software – Método eDoc_Envio_XML_NFe_OutroSoftware

Este método tem por objetivo obter o XML ou DANFE das notas enviadas para o Repositório NF-e Emitidas Outro Software.

Os parâmetros Header necessários para realizar a chamada a este web service são:


Authorization : vai conter a codificação do usuário e senha utilizados para autenticar o Rest. Estes dados devem ser obtidos junto a equipe Datamex.

Após obter o usuário e senha é preciso enviar um Header codificando o usuário e senha no padrão base64_encode. Segue o exemplo

Usuario:teste

Senha:teste

Gerando base64_encode utilizando php: base64_encode(“teste:teste”) ficaria: dGVzdGU6dGVzdGU=

Deste modo enviaríamos o Header abaixo:
Authorization: Basic dGVzdGU6dGVzdGU=

Os parâmetros do Body necessários para realizar a chamada ao web service são:

p: Ambiente -> indica o projeto que vai executar o Rest.

f: executarHub -> essa é a função padrão do projeto Ambiente que faz a chamada ao Hub indicado.

hub: nome interno do parâmetro do Hub criado pela equipe de suporte/implantação da Datamex. (Esse nome tem que ser solicitado junto a equipe Datamex)

empresaCNPJ: informar um cnpj sem formatação, exemplo:
11484819000156. Este filtro irá buscar por notas de uma empresa que correspondam ao cnpj informado.

chaveNFe : enviar a chave da nota a ser consultada, exemplo:
43171205503548000178550010012347701248318832 .

pdfOuXml: receberá o valor X|P -> Caso informado valor ‘P’ vai devolver um o base64 encode da DANFE das NF-e consutadas, caso informar valor X irá devolver o XML da NF-e. Por padrão sempre é enviado o XML.

periodoInicio: informar uma data de emissão, exemplo: 2019-01-01 -> está data irá filtrar notas com a data de emissão maior ou igual a data informada.

periodoFim: informar uma data de emissão, exemplo: 2019-01-01 -> está data irá filtrar notas com a data de emissão menor ou igual a data informada.

Segue um exemplo de Requisição Rest via PHP utilizando a biblioteca cURL:

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => "http://dominioclientedatamex/ws/",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => "------WebKitFormBoundary7MA4YWxkTrZu0gW\r\nContent-Disposition: form-data; name=\"p\"\r\n\r\nAmbiente\r\n------WebKitFormBoundary7MA4YWxkTrZu0gW\r\nContent-Disposition: form-data; name=\"f\"\r\n\r\nexecutaHub\r\n------WebKitFormBoundary7MA4YWxkTrZu0gW\r\nContent-Disposition: form-data; name=\"hub\"\r\n\r\nnomeinternodatamex\r\n------WebKitFormBoundary7MA4YWxkTrZu0gW\r\nContent-Disposition: form-data; name=\"empresaCNPJ\"\r\n\r\n14654654546\r\n------WebKitFormBoundary7MA4YWxkTrZu0gW\r\nContent-Disposition: form-data; name=\"pdfOuXml\"\r\n\r\nX\r\n------WebKitFormBoundary7MA4YWxkTrZu0gW\r\nContent-Disposition: form-data; name=\"chaveNFe\"\r\n\r\n13123123131231231231231\r\n------WebKitFormBoundary7MA4YWxkTrZu0gW\r\nContent-Disposition: form-data; name=\"periodoInicio\"\r\n\r\n2019-04-09\r\n------WebKitFormBoundary7MA4YWxkTrZu0gW\r\nContent-Disposition: form-data; name=\"periodoFim\"\r\n\r\n2019-05-07\r\n------WebKitFormBoundary7MA4YWxkTrZu0gW--",
  CURLOPT_HTTPHEADER => array(
    "Accept: */*",
    "Accept-Encoding: gzip, deflate",
    "Authorization: Basic 1W2kcmVpOkBz432y131222==",
    "Cache-Control: no-cache",
    "Connection: keep-alive",
    "Content-Length: 1028",
    "Content-Type: multipart/form-data; boundary=--------------------------698851572680415021435767",
    "Cookie: PSD=qv093dkabttbmce6klcconop03",
    "content-type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW"
  ),
));

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

Segue exemplos de retorno desta requisição:

{"sucesso":true,"msg":["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"]}

O retorno acima seria um retorno de sucesso, neste método estamos enviando o conteúdo de um arquivo zip codificado em base64, desta forma para obter os arquivos XML ou Danfe será necessário decodificar o conteúdo e salvar em um arquivo no formato ZIP. Após realizar este procedimento já pode ser extraído o conteúdo do ZIP que conterá os arquivos enviados.

{"sucesso":false,"erro":["Nenhum conteúdo encontrado."]}

No retorno acima não foi possível encontrar nenhum arquivo PDF ou XML.

FICOU COM DÚVIDA? Encaminhe e-mail para: suporte@datamex.com.br
Se preferir falar conosco:
Porto Alegre / RS 051 4063 8343
Rio Grande / RS 053 3036 2525
Caxias do Sul / RS 054 4062 9320
Rio de Janeiro / RJ 021 4063 8395
Itajaí / SC 047 4054 9320
Paranaguá / PR 041 4064 9110
Belo Horizonte / MG 031 4063 8310
São Paulo / SP 011 4063 8395


AINDA NÃO É CLIENTE DATAMEX? Não perca tempo, conheça a solução Datamex para a Gestão de Transportadoras, Armazéns Gerais e Empresas de Logística: Emissor de CTe, MDFe, CIOT e EDI