PHPackages                             liontecnologia/ciot-php-sdk - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. liontecnologia/ciot-php-sdk

ActiveLibrary[API Development](/categories/api)

liontecnologia/ciot-php-sdk
===========================

Biblioteca PHP oficial para integração com a API AILOG CIOT. Emita, retifique, encerre e consulte Certificados de Inscrição e Operação de Transporte.

01PHP

Since Mar 30Pushed 3mo agoCompare

[ Source](https://github.com/liontecnologia/ailog-ciot)[ Packagist](https://packagist.org/packages/liontecnologia/ciot-php-sdk)[ RSS](/packages/liontecnologia-ciot-php-sdk/feed)WikiDiscussions main Synced 3w ago

READMEChangelogDependenciesVersions (1)Used By (0)

AILOG CIOT PHP SDK
==================

[](#ailog-ciot-php-sdk)

[![Latest Version on Packagist](https://camo.githubusercontent.com/97bd54853b0f54f70643fa4db858ff1238e0cdc06a687fde3a21f60106873224/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f61696c6f672f63696f742d7068702d73646b2e737667)](https://packagist.org/packages/ailog/ciot-php-sdk)[![License](https://camo.githubusercontent.com/7b45c307d66b05af9fbf8a87724f7b7f9b10205240f95ecfff2f6efbc6885762/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f61696c6f672f63696f742d7068702d73646b2e737667)](LICENSE)[![PHP Version](https://camo.githubusercontent.com/2f2d3f06087ded010c1906d0513bd568081fdf7df8f13e35c1d76eb819cfd148/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f61696c6f672f63696f742d7068702d73646b2e737667)](https://packagist.org/packages/ailog/ciot-php-sdk)

Biblioteca PHP oficial para integração com a **API AILOG CIOT**. Permite emitir, retificar, encerrar e consultar Certificados de Inscrição e Operação de Transporte (CIOT) para transportadoras de carga.

📋 Recursos
----------

[](#-recursos)

- ✅ Emissão de CIOT
- ✅ Retificação de CIOT
- ✅ Encerramento de CIOT
- ✅ Cancelamento de CIOT
- ✅ Consulta de CIOT
- ✅ Consulta de Situação do Transportador
- ✅ Consulta de Frota do Transportador
- ✅ Tratamento robusto de erros
- ✅ Suporte para ambientes HML e PROD

📦 Instalação
------------

[](#-instalação)

Via Composer:

```
composer require ailog/ciot-php-sdk
```

**Requisitos:**

- PHP >= 7.4
- Extensão JSON
- Extensão cURL

🚀 Quickstart
------------

[](#-quickstart)

```
require 'vendor/autoload.php';

use Ailog\Ciot\AilogClient;
use Ailog\Ciot\Services\CiotService;

// Inicializar cliente
$client = new AilogClient('sua_chave_api', 'HML');
$ciotService = new CiotService($client);

// Emitir CIOT
$dados = [
    "tipoViagem" => 1,
    "codigoCliente" => "PEDIDO_001",
    // ... mais dados
];

$resultado = $ciotService->emitir($dados);
echo "CIOT emitido: " . $resultado['numeroProtocoloCiot'];
```

📚 Documentação
--------------

[](#-documentação)

Para exemplos completos e detalhados, consulte:

- **[Manual Completo](manual/README.md)** - Documentação técnica completa
- **[Exemplos Práticos](examples/README.md)** - 8 exemplos passo a passo
    - 00 - Configuração Inicial
    - 01 - Emissão de CIOT
    - 02 - Retificação de CIOT
    - 03 - Encerramento de CIOT
    - 04 - Cancelamento de CIOT
    - 05 - Consulta de CIOT
    - 06 - Consulta Situação Transportador
    - 07 - Consulta de Frota

🔧 Configuração Inicial
----------------------

[](#-configuração-inicial)

```
use Ailog\Ciot\AilogClient;
use Ailog\Ciot\Services\CiotService;
use Ailog\Ciot\Services\TransportadorService;

$apiKey = 'SUA_CHAVE_DE_ACESSO';
$environment = 'HML'; // ou 'PROD'

$client = new AilogClient($apiKey, $environment);
$ciotService = new CiotService($client);
$transportadorService = new TransportadorService($client);
```

---

1. Emissão de CIOT
------------------

[](#1-emissão-de-ciot)

**Método:** `$ciotService->emitir($dados)`

```
$dadosEmissao = [
    "tipoViagem" => 1, // 1 = Padrão, 3 = TAC Agregado
    "codigoCliente" => "PEDIDO_INT_001", // Seu identificador interno

    // Lista de Veículos
    "veiculos" => [
        [
            "placa" => "ABC1234",
            "rntrc" => "12345678"
        ],
        [
            "placa" => "XYZ9876", // Reboque se houver
            "rntrc" => "12345678"
        ]
    ],

    // Dados do Contratado (Transportador)
    "documentoContratado" => "12345678000199", // CNPJ ou CPF
    "rntrcContratado" => "12345678",
    "nomeContratado" => "TRANSPORTADORA EXEMPLO LTDA",

    // Dados do Contratante
    "documentoContratante" => "98765432000100",
    "rntrcContratante" => "87654321", // Opcional se não for transportador
    "nomeContratante" => "EMPRESA CONTRATANTE S.A.",
    "enderecoContratante" => [
        "cidade" => [
            "pais" => "Brasil",
            "uf" => "SP",
            "cidade" => "São Paulo",
            "codigoIbge" => 3550308, // Código IBGE da cidade
            "label" => "São Paulo, SP"
        ],
        "logradouro" => "Av. Paulista",
        "numero" => "1000",
        "complemento" => "Andar 5",
        "cep" => "01310-100",
        "bairro" => "Bela Vista",
        "latLng" => [
            "latitude" => -23.561684,
            "longitude" => -46.655981
        ]
    ],

    // Dados do Destinatário
    "documentoDestinatario" => "11222333000199",
    "nomeDestinatario" => "CLIENTE FINAL LTDA",
    "rntrcDestinatario" => "", // Opcional
    "enderecoDestinatario" => [
        "cidade" => [
            "pais" => "Brasil",
            "uf" => "RJ",
            "cidade" => "Rio de Janeiro",
            "codigoIbge" => 3304557
        ],
        "logradouro" => "Av. Atlântica",
        "numero" => "500",
        "complemento" => "",
        "cep" => "22010-000",
        "bairro" => "Copacabana",
        "latLng" => [
            "latitude" => -22.969442,
            "longitude" => -43.178465
        ]
    ],

    // Dados da Operação
    "codigoNaturezaCarga" => "0001", // Se não souber, enviar 0001

    "cidadeOrigem" => [
        "pais" => "Brasil",
        "uf" => "SP",
        "cidade" => "São Paulo",
        "codigoIbge" => 3550308
    ],
    "cepOrigem" => "01310-100",

    "cidadeDestino" => [
        "pais" => "Brasil",
        "uf" => "RJ",
        "cidade" => "Rio de Janeiro",
        "codigoIbge" => 3304557
    ],
    "cepDestino" => "22010-000",

    // Dados de Retorno (Opcional)
    "cepRetorno" => "",
    "distanciaRetorno" => 0,
    "freteRetorno" => false,

    // Detalhes da Viagem
    "dataInicioViagem" => "10/02/2026", // dd/mm/aaaa
    "dataFimViagem" => "12/02/2026",
    "distanciaPercorrida" => 430.5, // Em KM
    "veiculoAltoDesempenho" => false,

    // Valores (Float)
    "valorFrete" => 1500.00,
    "valorPedagio" => 120.50,
    "valorCombustivel" => 0.00, // Se houver adiantamento/vale
    "valorTarifas" => 5.00, // Tarifas bancárias/operacionais
    "valorImpostos" => 0.00,
    "quantidadeTarifas" => 1,
    "pesoCarga" => 15000, // Em KG

    // Dados de Pagamento
    "tipoPagamento" => "CONTA_CORRENTE", // Opções: IPEF, CONTA_CORRENTE, CONTA_POUPANCA, CONTA_DE_PAGAMENTO, OUTROS
    "codigoBanco" => "341", // Código do banco (ex: 341 Itaú)
    "agencia" => "1234",
    "numeroConta" => "56789-0",
    "cpfProprietarioConta" => "12345678900" // CPF do titular da conta
];
```

---

2. Retificação de CIOT
----------------------

[](#2-retificação-de-ciot)

**Método:** `$ciotService->retificar($dados)`

```
$dadosRetificacao = [
    "numeroProtocoloCiot" => "1234567890123456", // Protocolo recebido na emissão

    // Campos que deseja alterar (exemplo: alterando veículo e valores)
    "placa" => "ABC1234", // Placa do veículo principal
    "rntrcTransportador" => "12345678",

    "quantidadeTarifas" => 2,
    "valorTarifas" => 10.00,

    "veiculos" => [
        [
            "placa" => "ABC1234",
            "rntrc" => "12345678"
        ]
    ]
];
```

---

3. Encerramento de CIOT
-----------------------

[](#3-encerramento-de-ciot)

**Método:** `$ciotService->encerrar($dados)`

```
$dadosEncerramento = [
    "numeroProtocoloCiot" => "1234567890123456",

    // Valores Finais Consolidados
    "pesoCargaTotal" => 15000,
    "quantidadeTarifas" => 1,
    "valorTarifas" => 5.00,

    // Rotas efetivamente realizadas
    "rotas" => [
        [
            "cepOrigem" => "01310-100",
            "codigoIbgeOrigem" => 3550308,
            "cepDestino" => "22010-000",
            "codigoIbgeDestino" => 3304557,
            "pesoCarga" => 15000,
            "quantidadeViagens" => 1,
            "codigoNaturezaCarga" => "0001"
        ]
    ]
];
```

---

4. Cancelamento de CIOT
-----------------------

[](#4-cancelamento-de-ciot)

**Método:** `$ciotService->cancelar($protocolo, $motivo)`

```
$protocolo = "1234567890123456";
$motivo = "Erro na digitação do valor do frete e cancelamento da viagem.";

// O retorno contém o status do cancelamento
$resultado = $ciotService->cancelar($protocolo, $motivo);
```

---

5. Consultas
------------

[](#5-consultas)

### Consultar Status do CIOT

[](#consultar-status-do-ciot)

```
$numeroCiot = "1234567890123";
$ano = 2026;

$resultado = $ciotService->consultar($numeroCiot, $ano);
```

### Consultar Situação do Transportador

[](#consultar-situação-do-transportador)

```
$documento = "12345678000199"; // CNPJ ou CPF
$rntrc = "12345678";

$resultado = $transportadorService->consultaSituacao($documento, $rntrc);
```

### Consultar Frota do Transportador

[](#consultar-frota-do-transportador)

```
$documento = "12345678000199";
$rntrc = "12345678";
$placas = ["ABC1234", "XYZ9876"]; // Array de placas

$resultado = $transportadorService->consultaFrota($documento, $rntrc, $placas);
```

###  Health Score

19

—

LowBetter than 9% of packages

Maintenance55

Moderate activity, may be stable

Popularity1

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity12

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://www.gravatar.com/avatar/567e6f558ae2cee94b1753f05915700f2eb385b8bb558ff9311e067d2684e05a?d=identicon)[ajoabe](/maintainers/ajoabe)

---

Top Contributors

[![liontecnologia](https://avatars.githubusercontent.com/u/55816003?v=4)](https://github.com/liontecnologia "liontecnologia (3 commits)")

### Embed Badge

![Health badge](/badges/liontecnologia-ciot-php-sdk/health.svg)

```
[![Health](https://phpackages.com/badges/liontecnologia-ciot-php-sdk/health.svg)](https://phpackages.com/packages/liontecnologia-ciot-php-sdk)
```

###  Alternatives

[exsyst/swagger

A php library to manipulate Swagger specifications

35816.3M7](/packages/exsyst-swagger)[hubspot/api-client

Hubspot API client

24015.5M18](/packages/hubspot-api-client)[pocketmine/bedrock-protocol

An implementation of the Minecraft: Bedrock Edition protocol in PHP

172437.8k11](/packages/pocketmine-bedrock-protocol)[botman/driver-telegram

Telegram driver for BotMan

94452.6k6](/packages/botman-driver-telegram)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)