ConhecimentoTransporteOsXML

Descrição

Conhecimento de Transporte - Outros Serviços. versão 3.0. Tag XML CTeOS

Atributos

cfop (obrigatório) Integer[4] Tag XML CFOP

CFOP da CT-e.

natureza_operacao (obrigatório) String[1-60] Tag XML natOp

Descrição da natureza de operação.

serie Integer[1-3] Tag XML serie

Série da CT-e. Deixe em branco para que a API se responsabilize pela numeração automática (recomendado)

numero Integer[1-9] Tag XML nCT

Número da CT-e. Deixe em branco para que a API se responsabilize pela numeração automática (recomendado)

data_emissao (obrigatório) Tag XML dhEmi

Data e hora de emissão.

tipo_documento (obrigatório) Tag XML tpCTe

Tipo do CT-e

Valores permitidos

  • 0: CT-e Normal

  • 1: CT-e de Complemento de Valores

  • 2: CT-e de Anulação

  • 3: CT-e Substituto

codigo_municipio_envio (obrigatório) Integer[7] Tag XML cMunEnv

Código do Município de envio do CT-e. Caso este campo seja omitido, o código será buscado a partir do nome e estado do município, caso contrário utilizar a tabela do IBGE. Informar 9999999 para operações com o exterior.

municipio_envio (obrigatório) String[2-60] Tag XML xMunEnv

Nome do município de envio do CT-e. Informar PAIS/Municipio para as operações com o exterior.

uf_envio (obrigatório) String[2] Tag XML UFEnv

Sigla da UF de envio do CT-e. Informar ‘EX’ para as operações com o exterior.

modal (obrigatório) Tag XML modal

Modal de transporte da CT-e OS

Valores permitidos

  • 01: Rodoviário

  • 02: Aéreo

  • 03: Aquaviário

  • 04: Ferroviário

  • 05: Dutoviário

  • 06: Multimodal

tipo_servico (obrigatório) Tag XML tpServ

Tipo do serviço prestado.

Valores permitidos

  • 6: Transporte de Pessoas

  • 7: Transporte de Valores

  • 8: Excesso de Bagagem

indicador_inscricao_estadual_tomador (obrigatório) Tag XML indIEToma

Indicador do papel do tomador na prestação do serviço.

Valores permitidos

  • 1: Contribuinte ICMS

  • 2: Contribuinte isento de inscrição

  • 9: Não Contribuinte

codigo_municipio_inicio (obrigatório) Integer[7] Tag XML cMunIni

Código do Município de início da prestação. Caso este campo seja omitido, o código será buscado a partir do nome e estado do município, caso contrário utilizar a tabela do IBGE. Informar 9999999 para operações com o exterior.

municipio_inicio (obrigatório) String[2-60] Tag XML xMunIni

Nome do município de início da prestação. Informar ‘EXTERIOR’ para as operações com o exterior.

uf_inicio (obrigatório) String[2] Tag XML UFIni

Sigla da UF de início da prestação. Informar ‘EX’ para as operações com o exterior.

codigo_municipio_fim (obrigatório) Integer[7] Tag XML cMunFim

Código do Município de término da prestação. Caso este campo seja omitido, o código será buscado a partir do nome e estado do município, caso contrário utilizar a tabela do IBGE. Informar 9999999 para operações com o exterior.

municipio_fim (obrigatório) String[2-60] Tag XML xMunFim

Nome do município de término da prestação. Informar ‘EXTERIOR’ para as operações com o exterior.

uf_fim (obrigatório) String[2] Tag XML UFFim

Sigla da UF de término da prestação. Informar ‘EX’ para as operações com o exterior.

percursos Coleção[0-25] [coleção: InfoPercursoOsXML]

Informações do Percurso do CT-e Outros Serviços

caracteristica_adicional_transporte String[1-15] Tag XML xCaracAd

Característica adicional de transporte. Texto livre: REENTREGA; DEVOLUÇÃO; REFATURAMENTO; etc.

caracteristica_adicional_servico String[1-30] Tag XML xCaracSer

Característica adicional de serviço. Texto livre: ENTREGA EXPRESSA; LOGÍSTICA REVERSA; CONVENCIONAL; EMERGENCIAL; etc

funcionario_emissor String[1-20] Tag XML xEmi

Funcionário emissor do CT-e.

observacoes String[1-2000] Tag XML xObs

Observações gerais.

observacoes_contribuinte Coleçao[0-10] [coleção: ObservacoesContribuinteXML]

Observações gerais.

observacoes_fisco Coleçao[0-10] [coleção: ObservacoesFiscoXML]

Observações gerais.

cnpj_emitente (obrigatório) Integer[14] Tag XML CNPJ

CNPJ do emitente. Omitir caso o tomador seja pessoa física e informar a tag ‘cpf_emitente’. Em caso de empresa não estabelecida no Brasil, será informado o CNPJ com zeros.

inscricao_estadual_emitente (obrigatório) Integer[14] Tag XML IE

Inscrição Estadual da empresa emitente.

inscricao_estadual_st_emitente (obrigatório) Integer[14] Tag XML IEST

Inscrição Estadual do Substituto Tributário da empresa emitente.

nome_emitente (obrigatório) String[2-60] Tag XML xNome

Razão Social ou nome da empresa emitente.

nome_fantasia_emitente (obrigatório) String[2-60] Tag XML xFant

Nome fantasia da empresa emitente.

logradouro_emitente (obrigatório) String[2-60] Tag XML xLgr

Logradouro (rua, avenida, travessa etc.) da empresa emitente.

numero_emitente (obrigatório) String[1-60] Tag XML nro

Número do endereço da empresa emitente.

complemento_emitente String[1-60] Tag XML xCpl

Complemento do endereço da empresa emitente.

bairro_emitente (obrigatório) String[2-60] Tag XML xBairro

Bairro da empresa emitente.

codigo_municipio_emitente (obrigatório) Integer[7] Tag XML cMun

Código do Município da empresa emitente. Caso este campo seja omitido, o código será buscado a partir do nome e estado do município, caso contrário utilizar a tabela do IBGE. Informar 9999999 para operações com o exterior.

municipio_emitente (obrigatório) String[2-60] Tag XML xMun

Município da empresa emitente.

cep_emitente Integer[8] Tag XML CEP

CEP da empresa emitente.

uf_emitente (obrigatório) String[2] Tag XML UF

UF da empresa emitente.

telefone_emitente Integer[6-14] Tag XML fone

Telefone da empresa emitente.

cnpj_tomador Integer[14] Tag XML CNPJ

CNPJ do tomador. Omitir caso o tomador seja pessoa física e informar a tag ‘cpf_tomador’. Em caso de empresa não estabelecida no Brasil, será informado o CNPJ com zeros.

cpf_tomador Integer[11] Tag XML CPF

CPF do tomador. Omitir caso o tomador seja pessoa jurídica e informar a tag ‘cnpj_tomador’.

inscricao_estadual_tomador Integer[14] Tag XML IE

Informar a IE do tomador ou ISENTO se tomador é contribuinte do ICMS isento de inscrição no cadastro de contribuintes do ICMS. Caso o tomador não seja contribuinte do ICMS não informar a tag.

nome_tomador (obrigatório) String[2-60] Tag XML xNome

Razão Social ou nome do tomador.

nome_fantasia_tomador (obrigatório) String[2-60] Tag XML xFant

Nome fantasia do tomador.

telefone_tomador (obrigatório) Integer[6-14] Tag XML fone

Telefone do tomador.

logradouro_tomador (obrigatório) String[2-255] Tag XML xLgr

Logradouro do tomador(rua, avenida, travessa etc.).

numero_tomador (obrigatório) String[1-60] Tag XML nro

Número do endereço do tomador.

complemento_tomador String[1-60] Tag XML xCpl

Complemento do tomador.

bairro_tomador (obrigatório) Integer[2-60] Tag XML xBairro

Bairro do tomador.

codigo_municipio_tomador (obrigatório) Integer[7] Tag XML cMun

Código do Município do tomador. Caso este campo seja omitido, o código será buscado a partir do nome e estado do município, caso contrário utilizar a tabela do IBGE. Informar 9999999 para operações com o exterior.

municipio_tomador (obrigatório) String[2-60] Tag XML xMun

Nome do município do tomador. Informar EXTERIOR para operações com o exterior.

cep_tomador (obrigatório) Integer[8] Tag XML CEP

CEP do endereço do tomador.

uf_tomador (obrigatório) String[2] Tag XML UF

Sigla da UF do tomador. Informar EX para operações com o exterior.

codigo_pais_tomador (obrigatório) Integer[1-4] Tag XML cPais

Código do país do tomador. Utilizar a tabela BACEN.

pais_tomador (obrigatório) String[2-60] Tag XML xPais

Nome do país do tomador.

email_tomador String[1-60] Tag XML email

Endereço de e-mail do tomador.

valor_total (obrigatório) Decimal[13.2] Tag XML vTPrest

Valor total da prestação de serviço.

valor_receber (obrigatório) Decimal[13.2] Tag XML vRec

Valor a receber.

componentes_valor Coleção[0-100] [coleção: ComponenteValorPrestacaoXML]

Componentes do Valor da Prestação

icms_situacao_tributaria (obrigatório) Tag XML CST

Situação tributária do ICMS.

Valores permitidos

  • 00: tributada integralmente

  • 40: isenta

  • 41: não tributada

  • 51: diferimento (a exigência do preenchimento das informações do ICMS diferido fica a critério de cada UF)

  • 90: outros (Regime Normal)

  • 90_outra_uf: outros (ICMS devido à UF de origem da prestação, quando diferente da UF do emitente)

  • 90_simples_nacional: outros (regime Simples Nacional)

icms_base_calculo Decimal[13.2] Tag XML vBC

Valor da base de cálculo do ICMS.

icms_aliquota Decimal[3.2-4] Tag XML pICMS

Alíquota do ICMS.

icms_valor Decimal[13.2] Tag XML vICMS

Valor do ICMS.

icms_reducao_base_calculo Decimal[3.2-4] Tag XML pRedBC

Percentual de redução da base de cálculo.

icms_valor_credito_presumido Decimal[13.2] Tag XML vCred

Valor crédito outorgado/Presumido.

icms_indicador_simples_nacional Tag XML indSN

Indicador de contribuinte Simples Nacional.

Valores permitidos

  • 1: Sim

valor_total_tributos Decimal[13.2] Tag XML vTotTrib

Valor total aproximado dos tributos

informacoes_adicionais_fisco String[1-2000] Tag XML infAdFisco

Informações adicionais de interesse do Fisco.

icms_base_calculo_uf_fim Decimal[13.2] Tag XML vBCUFFim

Valor da BC do ICMS na UF de término da prestação do serviço de transporte.

icms_percentual_fcp_uf_fim Decimal[3.2] Tag XML pFCPUFFim

Percentual do ICMS relativo ao Fundo de Combate à pobreza (FCP) na UF de término da prestação do serviço de transporte.

icms_aliquota_interna_uf_fim Decimal[3.2] Tag XML pICMSUFFim

Alíquota interna da UF de término da prestação do serviço de transporte.

icms_aliquota_interestadual_uf_fim Decimal[3.2] Tag XML pICMSInter

Alíquota interestadual das UF envolvidas

icms_percentual_partilha_uf_fim Decimal[3.2] Tag XML pICMSInterPart

Percentual provisório de partilha entre os estados. (Valor padrão de 100% a partir de 2019)

icms_valor_total_fcp_uf_fim Decimal[13.2] Tag XML vFCPUFFim

Valor do ICMS relativo ao Fundo de Combate á Pobreza (FCP) da UF de término da prestação.

icms_valor_partilha_uf_fim Decimal[13.2] Tag XML vICMSUFFim

Valor do ICMS de partilha para a UF de término da prestação do serviço de transporte.

icms_valor_partilha_uf_inicio Decimal[13.2] Tag XML vICMSUFIni

Valor do ICMS de partilha para a UF de início da prestação do serviço de transporte.

valor_pis Decimal[13.2] Tag XML vPIS

Valor do PIS.

valor_cofins Decimal[13.2] Tag XML vCOFINS

Valor do COFINS.

valor_ir Decimal[13.2] Tag XML vIR

Valor do Imposto de Renda.

valor_inss Decimal[13.2] Tag XML vINSS

Valor do INSS.

valor_csll Decimal[13.2] Tag XML vCSLL

Valor do CSLL.

descricao_servico String[1-30] Tag XML xDescServ

Descrição do serviço prestado

quantidade Decimal[11.4] Tag XML qCarga

Descrição do serviço prestado

documentos_referenciados Coleção[0-100] [coleção: InfoDocumentoReferenciaXML]

Informações dos documentos referenciados

seguros_carga Coleção[0-100] [coleção: InfoSeguroCargaXML]

Informações de Seguro da Carga

chave_cte_original_sub String[44] Tag XML chCte

CTe Substituição: Chave de acesso do CT-e a ser substituído (original)

chave_cte_anulacao_sub String[44] Tag XML refCteAnu

CTe Substituição: Chave de acesso do CT-e de Anulação

chave_nfe_tomador_sub String[44] Tag XML refNFe

CTe Substituição: Chave de acesso da NF-e emitida pelo Tomador

cnpj_emissor_sub Integer[14] Tag XML CNPJ

CTe Substituição: CNPJ. Se este campo for informado não deve ser informado o CPF.

cpf_emissor_sub Integer[11] Tag XML CPF

CTe Substituição: CPF. Se este campo for informado não deve ser informado o CNPJ.

modelo_documento_sub String[2] Tag XML mod

CTe Substituição: Modelo do Documento Fiscal

serie_documento_sub Integer[1-3] Tag XML serie

CTe Substituição: Serie do documento fiscal

subserie_documento_sub Integer[1-3] Tag XML subserie

CTe Substituição: Subserie do documento fiscal

numero_documento_sub Integer[1-6] Tag XML nro

CTe Substituição: Número do documento fiscal

valor_documento_sub Decimal[13.2] Tag XML valor

CTe Substituição: Valor do documento fiscal.

data_emissao_documento_sub Tag XML dEmi

CTe Substituição: Data de emissão do documento fiscal.

chave_cte_sub Integer[44] Tag XML refCte

CTe Substituição: Chave de acesso do CT-e emitido pelo Tomador

chave_cte_cancelado String[44] Tag XML chCte

Chave do CT-e cancelada

numero_fatura String[1-60] Tag XML nFat

Número da fatura

valor_original_fatura Decimal[13.2] Tag XML vOrig

Valor original da fatura

valor_desconto_fatura Decimal[13.2] Tag XML vDesc

Valor do desconto da fatura

valor_liquido_fatura Decimal[13.2] Tag XML vLiq

Valor líquido da fatura

duplicatas Coleção[1-100] [coleção: DadoDuplicataXML]

Dados das duplicatas

chave_cte_complementado String[44] Tag XML chCTe

Chave do CT-e complementado

chave_cte_original_anulado String[44] Tag XML chCte

CTe Anulação: Chave de acesso do CT-e original a ser anulado e substituído

data_declaracao_anulacao Tag XML dEmi

CTe Anulação: Data de emissão da declaração do tomador não contribuinte do ICMS

pessoas_autorizadas Coleção[0-10] [coleção: PessoaAutorizadaXML]

Pessoas autorizadas a acessar o XML da CT-e