Pular para o conteúdo principal
Ver como MarkdownDocs para agentes

Conhecimentos de transporte recebidos (CT-e)

client.transportation_invoices gerencia CT-e (Conhecimento de Transporte Eletrônico) recebidos, no host api.nfse.io, sob /v2. Ele habilita a busca automática via SEFAZ Distribuição DFe e lê documentos e eventos por chave de acesso de 44 dígitos.

Recurso de entrada, não de emissão

Este é um recurso de consulta/configuração (settings + buscas por chave de acesso). Não há contrato 202 Pending / Issued aqui — não se emite CT-e por este recurso.

Métodos​

MétodoDescriçãoRetorno
enable(company_id:, start_from_nsu: nil, start_from_date: nil)Habilita a busca automática de CT-e.Nfe::InboundSettings
disable(company_id:)Desabilita a busca automática.Nfe::InboundSettings
get_settings(company_id:)Lê as configurações atuais de busca.Nfe::InboundSettings
retrieve(company_id:, access_key:)Metadados do CT-e por chave de acesso.Nfe::InboundInvoiceMetadata
download_xml(company_id:, access_key:)XML do CT-e.String binária
get_event(company_id:, access_key:, event_key:)Metadados de um evento do CT-e.Nfe::InboundInvoiceMetadata
download_event_xml(company_id:, access_key:, event_key:)XML de um evento do CT-e.String binária
Chave de acesso normalizada

A access_key é normalizada por Nfe::IdValidator.access_key: separadores (espaços, pontos, traços) são removidos e o valor precisa ter exatamente 44 dígitos. Caso contrário, o SDK levanta Nfe::InvalidRequestError antes de qualquer chamada HTTP.

Habilitar a busca automática​

settings = client.transportation_invoices.enable(
  company_id: "55df4dc6b6cd9007e4f13ee8",
  start_from_date: "2026-01-01"
)
settings   # Nfe::InboundSettings

start_from_nsu e start_from_date são opcionais; quando nil, são omitidos do corpo da requisição.

Ler um CT-e recebido por chave de acesso​

access_key = "35240611111111000199570010000012341000012345"

cte = client.transportation_invoices.retrieve(
  company_id: company_id,
  access_key: access_key
)

xml = client.transportation_invoices.download_xml(
  company_id: company_id,
  access_key: access_key
)
File.binwrite("cte.xml", xml)

Consultar e baixar um evento​

evento = client.transportation_invoices.get_event(
  company_id: company_id,
  access_key: access_key,
  event_key: "35240611111111000199570010000012341000012345-110111-01"
)

xml = client.transportation_invoices.download_event_xml(
  company_id: company_id,
  access_key: access_key,
  event_key: evento.id
)
File.binwrite("cte-evento.xml", xml)

Próximos passos​

NFE.io

A NFE.io é uma empresa de tecnologia que fornece soluções para automatizar e simplificar a emissão e gestão de notas fiscais eletrônicas. Com suas ferramentas, as empresas podem economizar tempo e reduzir erros, aumentando a eficiência e precisão do processo de emissão de notas fiscais.

Um dos principais cases de sucesso da NFE.io é a implementação da solução na empresa de transporte Rodonaves. Com a automatização da emissão e gestão de notas fiscais eletrônicas, a Rodonaves conseguiu reduzir em até 80% o tempo gasto nesse processo, o que se traduziu em uma significativa melhoria na eficiência operacional. Além disso, a empresa também conseguiu eliminar erros e atrasos na emissão de notas fiscais, o que melhorou a relação com seus clientes e aumentou a confiança dos órgãos fiscais.

Outro exemplo é a implementação da NFE.io na empresa de comércio eletrônico, a Loja Integrada. Com a automatização da emissão de notas fiscais, a Loja Integrada conseguiu aumentar a velocidade de emissão de notas em até 10 vezes, o que permitiu que a empresa atendesse a uma maior quantidade de clientes e, consequentemente, aumentar as suas vendas.

Além desses exemplos, a NFE.io também tem outros cases de sucesso com empresas de setores como indústria, construção, varejo e serviços, mostrando a versatilidade e eficácia da sua solução.

Em resumo, a NFE.io é uma empresa de tecnologia que oferece soluções para automatizar e simplificar a emissão e gestão de notas fiscais eletrônicas, ajudando as empresas a economizar tempo e reduzir erros, melhorando a eficiência e precisão do processo. Com cases de sucesso em diferentes setores, a NFE.io tem se destacado como uma empresa líder em automação fiscal.