4. Gerar o XML da DC-e 4.4. Destinatário da DC-e: 4.3. Dados da Transportadora
« Anterior; 4.5. Autorizados Download
Próximo »

4.4. Destinatário da DC-e

Funcionalidade para gerar o XML do grupo do Destinatário da DC-e

Assinatura

string emit(string CNPJ, string CPF, string idOutros, string xNome, string xLgr, string nro, string xCpl_Opc, string xBairro, string cMun, string xMun, string UF, string CEP, string cPais, string xPais, string fone_Opc)

Descrição:

Funcionalidade para gerar o XML do grupo do Destinatário da DC-e

Parâmetros:

nome	tipo	tam.	obrig.	descrição
*CNPJ*	string	14	sim	informar o CNPJ do destinatário quando pessoa jurídica, sem formatação ou máscara, deve ser informado com 14 dígitos.
*CPF*	string	11	sim	informar o CPF do destinatário quando pessoa física, sem formatação ou máscara, deve ser informado com 11 dígitos.
*idOutros*	string	2-60	sim	Identificação do destinatário não obrigado a inscrição do CPF ou CNPJ tais como estrangeiro, indígena e quilombola. Observação: Campo aceita algarismos, letras (maiúsculas e minúsculas) e os caracteres do conjunto que segue: [:.+-/()]
*xNome*	string	2-60	sim	informar a razão social do destinatário.
*xLgr*	string	2-60	sim	informar o logradouro do destinatário.
*nro*	string	1-60	sim	informar o número do endereço do destinatário, campo obrigatório. Informar S/N ou . (ponto) ou - (traço) para evitar falha de schema XML quando não houver número.
*xCpl_Opc*	string	1-60	não	informar o complemento do endereço do destinatário, pode ser omitido.
*xBairro*	string	2-60	sim	informar o bairro do endereço do destinatário.
*cMun*	string	7	sim	informar o código do município na codificação do IBGE com 7 dígitos. Utilizar a Tabela de Municípios Informar 9999999 para operações com o exterior.
*xMun*	string	2-60	sim	informar o nome do município. Informar 'EXTERIOR' para operações com o exterior.
UF	string	2	sim	informar a sigla da UF. Informar 'EX' para operações com o exterior.
*CEP*	string	8	sim	informar o CEP.
*cPais*	string	4	sim	informar o código do País, 1058-Brasil. Utilizar a Tabela de Países.
*xPais*	string	1-60	sim	informar o nome do País, Brasil ou BRASIL.
*fone_Opc*	string	6-14	não	informar o telefone do destinatário. Preencher com o Código DDD + número do telefone. Nas operações com exterior é permitido informar o código do país + código da localidade + número do telefone
*email_Opc*	string	6-14	não	informar o e-mail do destinatário.

Diagrama:

DiagramaDestinatario

Dica

Informar o CNPJ ou o CPF do destinatário, preenchendo os zeros não significativos. No caso de operação com o exterior, ou para destinatário estrangeiro informar a tag "idOutros”.

Retorno:

Um string com o grupo XML do destinatário

XML:

Destinatário Pessoa Jurídica (CNPJ)

 
<dest>
  <CNPJ>00000000037940</CNPJ>
  <xNome>Banco do Brasil S/A Ourinhos-SP</xNome>
  <enderDest>
    <xLgr>Rua Antonio Carlos Mori</xLgr>
    <nro>530</nro>
    <xBairro>Centro</xBairro>
    <cMun>3534708</cMun>
    <xMun>Ourinhos</xMun>
    <UF>SP</UF>
    <CEP>19900081</CEP>
    <cPais>1058</cPais>
    <xPais>Brasil</xPais>
    <fone>1433023000</fone>
    <email>ourinhos@bb.com.br</email>
  </enderDest>
</dest>

Destinatário Pessoa Física (CPF)

 
  <CPF>00000000191</CPF>
  <xNome>Fulano de Paula</xNome>
  <enderDest>
    <xLgr>Rua Antonio Carlos Mori</xLgr>
    <nro>103</nro>
    <xCpl>Fundos</xCpl>
    <xBairro>Centro</xBairro>
    <cMun>3534708</cMun>
    <xMun>Ourinhos</xMun>
    <UF>SP</UF>
    <CEP>19900080</CEP>
    <cPais>1058</cPais>
    <xPais>Brasil</xPais>
    <fone>14991112222</fone>
    <email>fulano@gmail.com</email>
  </enderDest>
</dest>

Destinatário Exterior (idOutros)

<dest>
  <idOutros>EX-12001</idOutros>
  <xNome>Xinglian Technology</xNome>
  <enderDest>
    <xLgr>Jalan Perusahaan Baru</xLgr>
    <nro>2630</nro>
    <xCpl>13600 Perai</xCpl>
    <xBairro>Kawasan Perusahaan Perai</xBairro>
    <cMun>9999999</cMun>
    <xMun>Exterior</xMun>
    <UF>EX</UF>
    <CEP>99999999</CEP>
    <cPais>4553</cPais>
    <xPais>Malasia</xPais>
    <fone>6043985955</fone>
    <email>xingliantech@gmail.com</email>
  </enderDest>
</dest>

Importante

O trecho do XML foi formatado para uma melhor visualização, a mensagem original não tem formatação.

Vale observar que a formatação pode corromper a assinatura digital, além de ocupar espaço e ser desnecessária, pois os browser exibem formatado.

Exemplos de uso:

Visual Basic 6.0 - destinatário CNPJ

 
' declara e instancia DLL

Dim objDCeUtil As Object
 
Set objDCeUtil = CreateObject("DCe_Util.Util")
 
' declarar parâmetros

Dim dest As String
Dim dest_CNPJ As String
Dim dest_CPF As String
Dim dest_idOutros As String
Dim dest_xNome As String
Dim dest_xLgr As String
Dim dest_nro As String
Dim dest_xCpl_Opc As String
Dim dest_xBairro As String
Dim dest_cMun As String
Dim dest_xMun As String
Dim dest_UF As String
Dim dest_CEP As String
Dim dest_cPais As String
Dim dest_xPais As String
Dim dest_fone_Opc As String
Dim dest_email_Opc As String
 
' inicializar parâmetros

dest = ""
dest_CNPJ = "00000000037940"
dest_CPF = ""
dest_idOutros = ""
dest_xNome = "Banco do Brasil S/A Ourinhos-SP"
dest_xLgr = "Rua Antonio Carlos Mori"
dest_nro = "530"
dest_xCpl_Opc = ""
dest_xBairro = "Centro"
dest_cMun = "3534708"
dest_xMun = "Ourinhos"
dest_UF = "SP"
dest_CEP = "19900081"
dest_cPais = "1058"
dest_xPais = "Brasil"
dest_fone_Opc = "1433023000"
dest_email_Opc = "ourinhos@bb.com.br"
 
' gera grupo dest

dest = objDCeUtil.dest(dest_CNPJ, _
                       dest_CPF, _
                       dest_idOutros, _
                       dest_xNome, _
                       dest_xLgr, _
                       dest_nro, _
                       dest_xCpl_Opc, _
                       dest_xBairro, _
                       dest_cMun, _
                       dest_xMun, _
                       dest_UF, _
                       dest_CEP, _
                       dest_cPais, _
                       dest_xPais, _
                       dest_fone_Opc, _
                       dest_email_Opc)
 
MsgBox dest, vbInformation, "Informação"

Visual Basic 6.0 - destinatário CPF

' declara e instancia DLL

Dim objDCeUtil As Object
 
Set objDCeUtil = CreateObject("DCe_Util.Util")
 
' declarar parâmetros

Dim dest As String
Dim dest_CNPJ As String
Dim dest_CPF As String
Dim dest_idOutros As String
Dim dest_xNome As String
Dim dest_xLgr As String
Dim dest_nro As String
Dim dest_xCpl_Opc As String
Dim dest_xBairro As String
Dim dest_cMun As String
Dim dest_xMun As String
Dim dest_UF As String
Dim dest_CEP As String
Dim dest_cPais As String
Dim dest_xPais As String
Dim dest_fone_Opc As String
Dim dest_email_Opc As String
 
' inicializar parâmetros

dest = ""
dest_CNPJ = ""
dest_CPF = "00000000191"
dest_idOutros = ""
dest_xNome = "Fulano de Paula"
dest_xLgr = "Rua Antonio Carlos Mori"
dest_nro = "103"
dest_xCpl_Opc = "Fundos"
dest_xBairro = "Centro"
dest_cMun = "3534708"
dest_xMun = "Ourinhos"
dest_UF = "SP"
dest_CEP = "19900080"
dest_cPais = "1058"
dest_xPais = "Brasil"
dest_fone_Opc = "14991112222"
dest_email_Opc = "fulano@gmail.com"
 
' gera grupo dest

dest = objDCeUtil.dest(dest_CNPJ, _
                       dest_CPF, _
                       dest_idOutros, _
                       dest_xNome, _
                       dest_xLgr, _
                       dest_nro, _
                       dest_xCpl_Opc, _
                       dest_xBairro, _
                       dest_cMun, _
                       dest_xMun, _
                       dest_UF, _
                       dest_CEP, _
                       dest_cPais, _
                       dest_xPais, _
                       dest_fone_Opc, _
                       dest_email_Opc)
 
MsgBox dest, vbInformation, "Informação"

Visual Basic 6.0 - destinatário idOutros

 
 
' declara e instancia DLL

Dim objDCeUtil As Object
 
Set objDCeUtil = CreateObject("DCe_Util.Util")
 
' declarar parâmetros

Dim dest As String
Dim dest_CNPJ As String
Dim dest_CPF As String
Dim dest_idOutros As String
Dim dest_xNome As String
Dim dest_xLgr As String
Dim dest_nro As String
Dim dest_xCpl_Opc As String
Dim dest_xBairro As String
Dim dest_cMun As String
Dim dest_xMun As String
Dim dest_UF As String
Dim dest_CEP As String
Dim dest_cPais As String
Dim dest_xPais As String
Dim dest_fone_Opc As String
Dim dest_email_Opc As String
 
' inicializar parâmetros

dest = ""
dest_CNPJ = ""
dest_CPF = ""
dest_idOutros = "EX-12001"
dest_xNome = "Xinglian Technology "
dest_xLgr = "Jalan Perusahaan Baru"
dest_nro = "2630"
dest_xCpl_Opc = "13600 Perai"
dest_xBairro = "Kawasan Perusahaan Perai"
dest_cMun = "9999999"
dest_xMun = "Exterior"
dest_UF = "EX"
dest_CEP = "99999999"
dest_cPais = "4553"
dest_xPais = "Malasia"
dest_fone_Opc = "6043985955"
dest_email_Opc = "xingliantech@gmail.com"
 
' gera grupo dest

dest = objDCeUtil.dest(dest_CNPJ, _
                       dest_CPF, _
                       dest_idOutros, _
                       dest_xNome, _
                       dest_xLgr, _
                       dest_nro, _
                       dest_xCpl_Opc, _
                       dest_xBairro, _
                       dest_cMun, _
                       dest_xMun, _
                       dest_UF, _
                       dest_CEP, _
                       dest_cPais, _
                       dest_xPais, _
                       dest_fone_Opc, _
                       dest_email_Opc)
 
MsgBox dest, vbInformation, "Informação"

4.4. Destinatário da DC-e 4. Gerar o XML da DC-e: « Anterior
4.3. Dados da Transportadora; Próximo »
4.5. Autorizados Download

Guia de Uso do DCe_Util v1.00