{"id":3605,"date":"2024-07-09T17:00:24","date_gmt":"2024-07-09T20:00:24","guid":{"rendered":"https:\/\/www.l2maker.com.br\/documentacao\/?p=3605"},"modified":"2024-09-26T16:18:47","modified_gmt":"2024-09-26T19:18:47","slug":"gerando-uma-mdf-e-sincrono-com-a-api-da-sefaz","status":"publish","type":"post","link":"https:\/\/www.l2maker.com.br\/documentacao\/2024\/07\/gerando-uma-mdf-e-sincrono-com-a-api-da-sefaz\/","title":{"rendered":"Gerando uma MDF-e S\u00edncrono com a API da SEFAZ"},"content":{"rendered":"\n

O processo resumido de gera\u00e7\u00e3o de uma MDF-e usando nossa API \u00e9 descrito abaixo. D\u00favidas e refer\u00eancias devem ser consultadas no material oficial disponibilizado pela SEFAZ,  em especial o manual oficial da SEFAZ, Notas t\u00e9cnicas e os XSDs disponibilizados no site: http:\/\/www.nfe.fazenda.gov.br\/portal\/principal.aspx<\/a> .<\/p>\n\n\n\n

Parte 1 – Gerando o XML<\/h1>\n\n\n\n
    \n
  1. Crie um conector<\/a>:\n
      \n
    • Caso o certificado n\u00e3o tenha explicito o CNPJ e Nome do emissor utilize a fun\u00e7\u00e3o: “SEFAZ – Definir dados do emissor<\/strong>(…)”. <\/li>\n<\/ul>\n<\/li>\n\n\n\n
    • O tipo do conector deve ser definido para “MDFE<\/strong>” usando a fun\u00e7\u00e3o “SEFAZ – Definir Tipo de Servi\u00e7o<\/strong>“.<\/li>\n\n\n\n
    • O servidor de destino \u00e9 o “SVRS<\/strong>” e deve ser definido usando a fun\u00e7\u00e3o ‘SEFAZ \u2013 Definir Servidor<\/strong>‘;<\/li>\n\n\n\n
    • Crie uma novo MDF-e atrav\u00e9s da fun\u00e7\u00e3o “SEFAZ XML – Criar novo XM<\/strong>L”, passando os seguintes par\u00e2metros:\n
        \n
      1. Conector;<\/li>\n\n\n\n
      2. “MDFE” (Letras) – Indica o tipo do documento a ser criado.<\/li>\n<\/ol>\n<\/li>\n\n\n\n
      3. Utilize a fun\u00e7\u00e3o “SEFAZ NF-e – Adicionar Elemento ao XML<\/strong>” para adicionar os dados do XML do documento. A fun\u00e7\u00e3o recebe como par\u00e2metro os seguintes itens:\n
          \n
        • O retorno da fun\u00e7\u00e3o “SEFAZ XML – Criar novo XM<\/strong>L<\/strong>“;<\/li>\n\n\n\n
        • No segundo par\u00e2metro ela recebe o caminho da tag a ser adicionada;<\/li>\n\n\n\n
        • No terceiro o valor a ser adicionado;<\/li>\n\n\n\n
        • E por \u00faltimo, como OPCIONAL a m\u00e1scara de formata\u00e7\u00e3o, caso n\u00e3o deseja que a fun\u00e7\u00e3o N\u00c3O formate<\/strong> o valor, adicione a constante “TString<\/mark><\/strong>” nesse par\u00e2metro. Neste caso, ser\u00e1 adicionado a tag com o texto exato passado no terceiro par\u00e2metro, evitando inclusive que valores ZERADOS sejam suprimidos.<\/li>\n<\/ul>\n<\/li>\n\n\n\n
        • Adicionar os dados do emitente (“MDFe\/infMDFe\/ide\/cUF”) usando a fun\u00e7\u00e3o “SEFAZ NF-e – Adicionar Elemento ao XML<\/strong>“;<\/li>\n\n\n\n
        • Ap\u00f3s adicionar todas as tags informe o hashCSRT atrav\u00e9s da fun\u00e7\u00e3o “SEFAZ NF-e – Adicionar Elemento ao XML<\/strong>“, passando os seguintes par\u00e2metros:\n
            \n
          • O retorno da fun\u00e7\u00e3o “SEFAZ XML – Criar novo XM<\/strong>L<\/strong>“;<\/li>\n\n\n\n
          • Caminho da tag: “MDFe\/infMDFe\/infRespTec\/hashCSRT<\/strong>“;<\/li>\n\n\n\n
          • Valor do CSRT usando o seguinte formato: “CSRT:<VALOR DO CSRT><\/mark><\/strong>“;<\/li>\n\n\n\n
          • No \u00faltimo campo informe a m\u00e1scara “${hashCSRT}<\/strong>“. Desta forma o hash ser\u00e1 calculado baseado nos dados do documento.<\/li>\n<\/ul>\n<\/li>\n\n\n\n
          • Ap\u00f3s informar todos os dados utilize a fun\u00e7\u00e3o “SEFAZ XML – Obter XML<\/strong>” para gerar o XML:. <\/li>\n\n\n\n
          • Ao final assine o XML, chamando a fun\u00e7\u00e3o “SEFAZ – Assinar XML<\/strong>“. e passando os seguintes par\u00e2metros:\n
              \n
            1. Conector (Variante);<\/li>\n\n\n\n
            2. XML Original – (Letras) Texto do XML gerado;<\/li>\n\n\n\n
            3. Nome da tag: Informar a constante Letras: “infMDFe<\/strong>“. <\/li>\n<\/ol>\n<\/li>\n\n\n\n
            4. Obter o retorno da fun\u00e7\u00e3o com o XML assinado e gravar em arquivo ou no banco usando as fun\u00e7\u00f5es  nativas do Maker:\n
                \n
              1. DICA: Para gravar no banco utilize um campo de texto longo (TEXT, CLOB) com o mesmo charset do XML (UTF-8) ou BLOB (Bytea, VARBINARY, Image, …); <\/li>\n<\/ol>\n<\/li>\n<\/ol>\n\n\n\n

                Parte 2 – Transmitindo o XML<\/h1>\n\n\n\n
                  \n
                1. Ap\u00f3s montar todo o XML  de MDF-e com os dados desejados precisamos envia-la para SEFAZ, para isso se utiliza a fun\u00e7\u00e3o “SEFAZ MDF-e – Recep\u00e7\u00e3o S\u00edncrona<\/strong>“;<\/li>\n\n\n\n
                2. Por fim, grave a resposta em XML da SEFAZ. Ela ser\u00e1 usada para verifica a situa\u00e7\u00e3o;<\/li>\n\n\n\n
                3. Usar a fun\u00e7\u00e3o “SEFAZ – Processar XML de Retorno<\/strong>” para verificar se retornou com sucesso, ou alguma instru\u00e7\u00e3o de erro.\n
                    \n
                  • Esta fun\u00e7\u00e3o trabalha de forma an\u00e1loga \u00e0 de montagem de XML, assim, as tags s\u00e3o reduzidas a uma forma de estrutura de pastas, de acordo com a esttutura do XML, assim, para pegar o tpAmbpor exemplo se passa o caminho completo: “retMDFe\/tpAmb<\/strong>“;<\/li>\n\n\n\n
                  • DICA: Utilize o depurador de fluxos do Maker para ver exatamente os dados retornados por essa fun\u00e7\u00e3o.<\/li>\n<\/ul>\n<\/li>\n<\/ol>\n\n\n\n

                    Parte 3 – XML de distribui\u00e7\u00e3o<\/h1>\n\n\n\n
                      \n
                    1. Para montar o XML de distribui\u00e7\u00e3o ser\u00e1 utilizada a fun\u00e7\u00e3o “SEFAZ – Montar XML de distribui\u00e7\u00e3o<\/strong>“, os par\u00e2metros de entrada s\u00e3o:\n
                        \n
                      1. O XML do lote enviado;<\/li>\n\n\n\n
                      2. O XML retornado na consulta da situa\u00e7\u00e3o do lote;<\/li>\n\n\n\n
                      3. Deixar em branco ir\u00e1 pegar a primeira;<\/li>\n\n\n\n
                      4. A fun\u00e7\u00e3o ir\u00e1 retornar o XML de distribui\u00e7\u00e3o que pode ser usado para enviar ao cliente e\/ou gerar a DANFE.<\/li>\n<\/ol>\n<\/li>\n<\/ol>\n\n\n\n

                        Parte 5 – Gerar DANFE<\/h1>\n\n\n\n
                          \n
                        1. Para gerar a DANFE em PDF utilize a fun\u00e7\u00e3o “SEFAZ NF-e – Gerar DANFE”<\/strong>, passando como par\u00e2metros:\n
                            \n
                          1. Caminho completo do arquivo XML de distribui\u00e7\u00e3o ou conte\u00fado do XML de distribui\u00e7\u00e3o (Letras);<\/li>\n<\/ol>\n<\/li>\n\n\n\n
                          2. DICA: Voc\u00ea pode obter o caminho relativo do PDF gerado atrav\u00e9s da seguinte sequencia:\n
                              \n
                            1. Remova o caminho absoluto do arquivo obtendo somente o nome;<\/li>\n\n\n\n
                            2. Adicione antes do nome do arquivo “tmp\/”;<\/li>\n\n\n\n
                            3. A URL final deve ficar “tmp\/nomeArquivo.pdf”;<\/li>\n\n\n\n
                            4. Use a fun\u00e7\u00e3o de abrir URL numa moldura, ou download para enviar para o cliente.<\/li>\n<\/ol>\n<\/li>\n<\/ol>\n","protected":false},"excerpt":{"rendered":"

                              O processo resumido de gera\u00e7\u00e3o de uma MDF-e usando nossa API \u00e9 descrito abaixo. D\u00favidas e refer\u00eancias devem ser consultadas no material oficial disponibilizado pela SEFAZ,  em especial o manual oficial da SEFAZ, Notas t\u00e9cnicas e os XSDs disponibilizados no site: http:\/\/www.nfe.fazenda.gov.br\/portal\/principal.aspx . Parte 1 – Gerando o XML Parte 2 – Transmitindo o XML […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[47],"tags":[],"class_list":["post-3605","post","type-post","status-publish","format-standard","hentry","category-documentacao"],"_links":{"self":[{"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/posts\/3605","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/comments?post=3605"}],"version-history":[{"count":10,"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/posts\/3605\/revisions"}],"predecessor-version":[{"id":3695,"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/posts\/3605\/revisions\/3695"}],"wp:attachment":[{"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/media?parent=3605"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/categories?post=3605"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/tags?post=3605"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}