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

Conhecimentos de transporte (CT-e)

$nfe->transportationInvoices gerencia o recebimento de CT-e de entrada (conhecimentos de transporte emitidos contra a sua empresa) no host api.nfse.io, sob /v2: habilitação/desabilitação da captura, consulta de documentos por chave de acesso e download de XMLs.

Recurso de entrada, não de emissão

Este recurso consome CT-e emitidos por terceiros. Ele usa a apiKey principal (não é família de dados).

Métodos​

MétodoDescriçãoRetorno
enable($companyId, $data)Habilita o recebimento de CT-e para a empresa.InboundSettings
disable($companyId)Desabilita o recebimento.InboundSettings
getSettings($companyId)Configurações atuais de captura.InboundSettings
retrieve($companyId, $accessKey)Consulta um CT-e por chave de acesso (44 dígitos).array
downloadXml($companyId, $accessKey)XML do CT-e.string (bytes crus)
getEvent($companyId, $accessKey, $eventKey)Consulta um evento do CT-e.array
downloadEventXml($companyId, $accessKey, $eventKey)XML de um evento.string

Habilitar o recebimento​

$settings = $nfe->transportationInvoices->enable('55df4dc6b6cd9007e4f13ee8', [
    'startFromDate' => '2026-01-01',
]);

// Conferir depois:
$settings = $nfe->transportationInvoices->getSettings($companyId);

Consultar um CT-e e baixar o XML​

$accessKey = '35260111222333000181570010000012341000012349';

$cte = $nfe->transportationInvoices->retrieve($companyId, $accessKey);

file_put_contents(
    'cte.xml',
    $nfe->transportationInvoices->downloadXml($companyId, $accessKey),
);
Chave de acesso é validada localmente

A chave de acesso precisa ter 44 dígitos; um valor com tamanho errado lança Nfe\Exception\InvalidRequestException antes de qualquer requisição.

Eventos do CT-e​

$evento = $nfe->transportationInvoices->getEvent($companyId, $accessKey, $eventKey);

file_put_contents(
    'cte-evento.xml',
    $nfe->transportationInvoices->downloadEventXml($companyId, $accessKey, $eventKey),
);

Desabilitar​

$nfe->transportationInvoices->disable($companyId);

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.