Fale Whatsapp
API (v1.0)
CIOT - Código Identificador da Operação de Transporte

Linguagens:
GET
Parameters

        

    

    


        
        

            
Request

            

                
            

            
{
    "numero": "1001",
    "identificacao": "PEDIDO-77",
    "tipo_operacao": "1",
    "data_inicio": "2026-11-10",
    "data_fim": "2026-11-12",
    "valor_frete": "4550.92",
    "contratante": {
        "cnpj": "11222333000181",
        "nome": "TRANSPORTADORA EXEMPLO LTDA",
        "rntrc": "12345678"
    },
    "contratado": {
        "cnpj": "22333444000181",
        "nome": "TRANSPORTADOR CONTRATADO LTDA",
        "rntrc": "87654321"
    },
    "destinatario": {
        "cnpj": "44555666000199",
        "nome": "DESTINATARIO EXEMPLO LTDA"
    },
    "motorista": {
        "cpf": "12345678909",
        "nome": "MOTORISTA EXEMPLO"
    },
    "veiculos": [
        {
            "placa": "BCD2E34",
            "eixos": "2",
            "rntrc": "87654321"
        }
    ],
    "carga": {
        "tipo": "05",
        "natureza": "8414",
        "peso": "1520"
    },
    "viagens": [
        {
            "quantidade": "1",
            "distancia": "560",
            "origem": {
                "cep": "85000000",
                "codigo_municipio": "4121604",
                "municipio": "Renascença",
                "uf": "PR"
            },
            "destino": {
                "cep": "88300000",
                "codigo_municipio": "4208203",
                "municipio": "Itajaí",
                "uf": "SC"
            }
        }
    ],
    "pagamentos": [
        {
            "forma": "1",
            "tipo": "5",
            "cnpj": "22333444000181",
            "chave_pix": "22333444000181",
            "vencimento": "2026-11-12",
            "valor": "4550.92"
        }
    ]
}


        

        

            
Responses - HTTP Code 200


            

                

                    

                        
                    

                    

                        

                            

                                
                            

                            
{
    "sucesso": true,
    "codigo": 5023,
    "mensagem": "Lote em processamento, aguarde alguns segundos e tente novamente utilizando o método /ciot/41261122333444000181927090000010011360347860 (https://www.integranotas.com.br/doc/ciot/ailog/mostra) para maiores informações.",
    "chave": "41261122333444000181927090000010011360347860"
}


                        

                    

                

                

                    

                        
                    

                    

                        

                            

                                
                            

                            
{
    "sucesso": false,
    "codigo": CODIGO,
    "mensagem": MENSAGEM
}


                        

                    

                

                

                    

                        
                    

                    

                        

                            

                                
                            

                            
{
    "sucesso": false,
    "codigo": 5001,
    "mensagem": "JSON com erros nos campos, para mais detalhes verifique a propriedade erros",
    "erros": [
        {
            "campo": "numero",
            "erro": "[] - A propriedade numero é obrigatório",
            "descricao": "Número do CIOT no emitente. Não pode se repetir: é ele que impede emitir o mesmo CIOT duas vezes",
            "detalhes": "1 a 9 digitos"
        }
    ]
}


                        

                    

                

                

                    

                        
                    

                    

                        

                            

                                
                            

                            
{
    "sucesso": false,
    "codigo": 5002,
    "mensagem": "Erros na geração do CIOT, para mais detalhes verifique a propriedade erros",
    "erros": [
        {
            "campo": "contratado.cnpj",
            "erro": "[] Deve ser informado o CNPJ ou o CPF",
            "descricao": "Documento do contratado",
            "detalhes": "contratado.cnpj; contratado.cpf"
        }
    ]
}


                        

                    

                

                

                    

                        
                    

                    

                        

                            

                                
                            

                            
{
    "sucesso": false,
    "codigo": 5008,
    "mensagem": "Esse CIOT já existe, utilize o método /ciot/41261122333444000181927090000010011360347860 (https://www.integranotas.com.br/doc/ciot/ailog/mostra) para maiores informações.",
    "chave": "41261122333444000181927090000010011360347860"
}


                        

                    

                

                

                    

                        
                    

                    

                        

                            

                                
                            

                            
{
    "sucesso": false,
    "codigo": 5004,
    "mensagem": "Acesso Indevido! O emitente [RAZAO SOCIAL DO EMITENTE] não possui a chave de acesso da AILOG configurada. A chave é fornecida pela AILOG no contrato do cliente. Para configurar acesse o gestão [https://gestao.integranotas.com.br], edite o emitente e acesse a aba Documentos Fiscais."
}