luannsr12/sdkcorreios

Sdk correios

v1.5.2 2025-06-13 04:50 UTC

Requires

• php: >=8.2

MIT

• Luan Alves

README

Uma SDK em PHP para rastrear encomendas dos correios gratuitamente.

💡 Requirements

The SDK Supports PHP version 8.2 or higher.

🖥️ Sites Disponiveis para busca

Se algum dos sites listados abaixo desejar ser removido da biblioteca, por favor, entre em contato pelo e-mail: [e-mail].

Status	Site	ID
✅	melhorrastreio.com.br (Recomendado)	0001
✅	encomenda.io	0002
✅	rastreadordepacotes.com.br	0003
❌	rastreamentocorreio.com	0004
✅	muambator.com.br	0005
✅	rastreiocorreios.com.br	0006
✅	linkcorreios.com.br	0007

Install Composer

Faça download do composer aqui: Download composer

linha de comando

 composer require luannsr12/sdkcorreios

Usando

 <?php 

   require 'vendor/autoload.php';

   use Sdkcorreios\Config\Services;
   use Sdkcorreios\Methods\Tracking;

   // Confira na tabela os IDs dos serviços
   Services::setServiceTracking('0001'); // ID do site de busca
   Services::setDebug(true);

   $tracking = new Tracking();
   $tracking->setCode("OBJETO1");
   $tracking->setCode("OBJETO2");

   // OR
   // $tracking->setCode("OBJETO1,OBJETO2");
   
   if(Services::$success){
      echo json_encode($tracking->get());
   }else{
      var_dump(Services::getMessageError()); 
   }

Response

 {
  "success": true,
  "result": [
    {
      "code": "QQ781772845BR",
      "status": "DELIVERED",
      "service_provider": "rastreiocorreios.com.br",
      "data": [
        {
          "date": "05-03-2024 12:54:09",
          "to": "",
          "from": "PORTO ALEGRE - RS",
          "location": "PORTO ALEGRE - RS",
          "originalTitle": "Objeto entregue ao destinatário",
          "details": "Objeto entregue ao destinatário"
        },
        {
          "date": "05-03-2024 10:41:25",
          "to": "PORTO ALEGRE - RS",
          "from": "PORTO ALEGRE - RS",
          "location": "PORTO ALEGRE - RS",
          "originalTitle": "Objeto saiu para entrega ao destinatário",
          "details": "Objeto saiu para entrega ao destinatário"
        },
        {
          "date": "29-02-2024 15:48:50",
          "to": "JOINVILLE - SC",
          "from": "JOINVILLE - SC",
          "location": "JOINVILLE - SC",
          "originalTitle": "Objeto postado",
          "details": "Objeto postado"
        }
      ]
    }
  ]
}

Get services

<?php

  require 'vendor/autoload.php';

  use Sdkcorreios\Config\Services;

  $services = Services::getServices();

  print_r($services);

Status

Status	Description
DELIVERED	Objeto entregue ao destinatário
NOBODYHOME	Carteiro não atendido
MOVEMENT	Objeto em transferência - por favor aguarde
OUT_DELIVERY	Objeto saiu para entrega ao remetente
DELIVERY_FAILURE	A entrega não pode ser efetuada
REFUSED_RECEIVE	Cliente recusou-se a receber
UNKNOWN_CUSTOMER	Cliente desconhecido no local
CUSTOMER_MOVED	Cliente mudou-se
NO_IDENTIFICATION	Destinatário não apresentou documento exigido
NEW_TRY	Será feita uma nova tentativa de entrega
RETURN_SENDER	Objeto será devolvido ao remetente
WAITING_WITHDRAWAL	Objeto aguardando retirada no endereço indicado
LATE	Objeto com atraso na entrega
RETURN	Objeto devolvido ao remetente
MAILBOX	Objeto disponível para retirada em Caixa Postal
NOTFOUND	Objeto não localizado
LOST	Objeto Extraviado
POSTED	Objeto postado
DISTRUBTION	Objeto recebido na unidade de distribuição
RECEIVED_BRAZIL	Objeto recebido no Brasil
STOLEN	Objeto roubado