Estatísticas RastreioBot
Meta: Calcular estatísticas com base nos pacotes cadastrados no RastreioBot
A ideia inicial seria apresentar os dados em um site, cujo banco de dados seria atualizado no fim de cada dia contendo todos os pacotes presentes no bot.
As estatísticas poderiam variar entre serviço usado para o envio, origem ou até destino no pacote.
Como participar do projeto
- Participe das conversas e votações na aba Discussions
- Abra issues
- Faça um pull request (resolvendo issues)
Código de Rastreamento
O código de rastreamento segue um padrão chamado S10, composto por:
- Duas letras, que correspondem ao serviço usado (Pac, Sedex etc);
- Nove números;
- Duas letras, que representam o país de origem.
Ou seja, o código SL123456789BR usa o serviço de sigla SL com envio originado no Brasil.
Exemplos de resposta do sistema dos correios
Abaixo estão exemplos de resposta dos Correios sem qualquer tipo de processamento. É exatamente assim que a informação é recebida e deve ser usada para os cálculos estatísticos.
{'objetos': [{'codObjeto': 'NL397471754BR', 'eventos': [{'codigo': 'PO', 'descricao': 'Objeto postado', 'dtHrCriado': '2023-03-08T04:30:24', 'tipo': '01', 'unidade': {'endereco': {}, 'nome': 'CHINA', 'tipo': 'País'}, 'urlIcone': '/public-resources/img/agencia-cor.png'}, {'codigo': 'BDE', 'descricao': 'Objeto entregue ao destinatário', 'dtHrCriado': '2023-03-06T15:05:00', 'tipo': '01', 'unidade': {'endereco': {'cidade': 'BRASILIA', 'uf': 'DF'}, 'tipo': 'Unidade de Distribuição'}, 'urlIcone': '/public-resources/img/smile.png'}, {'codigo': 'OEC', 'descricao': 'Objeto saiu para entrega ao destinatário', 'dtHrCriado': '2023-03-06T11:39:32', 'tipo': '01', 'unidade': {'endereco': {'cidade': 'BRASILIA', 'uf': 'DF'}, 'tipo': 'Unidade de Distribuição'}, 'urlIcone': '/public-resources/img/pre-atendimento-cor.png'}, {'codigo': 'RO', 'descricao': 'Objeto em trânsito - por favor aguarde', 'dtHrCriado': '2023-03-02T12:29:19', 'tipo': '01', 'unidade': {'endereco': {'cidade': 'BRASILIA', 'uf': 'DF'}, 'tipo': 'Unidade de Tratamento'}, 'unidadeDestino': {'endereco': {'cidade': 'BRASILIA', 'uf': 'DF'}, 'nome': 'CDD BRASILIA ASA NORTE', 'tipo': 'CDD'}, 'urlIcone': '/public-resources/img/caminhao-cor.png'}, {'codigo': 'RO', 'descricao': 'Objeto em trânsito - por favor aguarde', 'dtHrCriado': '2023-02-27T07:14:01', 'tipo': '01', 'unidade': {'endereco': {'cidade': 'CURITIBA', 'uf': 'PR'}, 'tipo': 'Unidade de Logística Integrada'}, 'unidadeDestino': {'endereco': {'cidade': 'BRASILIA', 'uf': 'DF'}, 'nome': 'CTE BRASILIA', 'tipo': 'CTE'}, 'urlIcone': '/public-resources/img/caminhao-cor.png'}, {'codigo': 'PAR', 'descricao': 'Fiscalização aduaneira finalizada', 'dtHrCriado': '2023-02-27T07:14:00', 'tipo': '10', 'unidade': {'endereco': {'cidade': 'CURITIBA', 'uf': 'PR'}, 'tipo': 'Unidade de Logística Integrada'}, 'urlIcone': '/public-resources/img/verificar-documento-cor.png'}, {'codigo': 'PAR', 'descricao': 'Objeto recebido pelos Correios do Brasil', 'dtHrCriado': '2023-02-26T08:06:15', 'tipo': '16', 'unidade': {'endereco': {'cidade': 'CURITIBA', 'uf': 'PR'}, 'tipo': 'Unidade de Logística Integrada'}, 'urlIcone': '/public-resources/img/brazil.png'}, {'codigo': 'PO', 'descricao': 'Objeto postado', 'dtHrCriado': '2023-02-23T03:40:19', 'tipo': '01', 'unidade': {'endereco': {}, 'nome': 'CHINA', 'tipo': 'País'}, 'urlIcone': '/public-resources/img/agencia-cor.png'}], 'tipoPostal': {'categoria': 'PACKET STANDARD IMPORTAÇÃO', 'descricao': 'CORREIOS PACKET STANDARD', 'sigla': 'NL'}, 'habilitaAutoDeclaracao': False, 'permiteEncargoImportacao': False, 'habilitaPercorridaCarteiro': False, 'bloqueioObjeto': False, 'possuiLocker': False, 'habilitaLocker': False, 'habilitaCrowdshipping': False}], 'quantidade': 1, 'resultado': 'Todos os Eventos', 'versao': '2.4.10'}
{'objetos': [{'codObjeto': 'QC540601395BR', 'dtPrevista': '2023-04-04T20:59:59', 'eventos': [{'codigo': 'BDE', 'descricao': 'Objeto entregue ao destinatário', 'dtHrCriado': '2023-03-31T14:18:42', 'tipo': '01', 'unidade': {'endereco': {'cidade': 'BRASILIA', 'uf': 'DF'}, 'tipo': 'Unidade de Distribuição'}, 'urlIcone': '/public-resources/img/smile.png'}, {'codigo': 'OEC', 'descricao': 'Objeto saiu para entrega ao destinatário', 'dtHrCriado': '2023-03-31T10:07:05', 'tipo': '01', 'unidade': {'endereco': {'cidade': 'BRASILIA', 'uf': 'DF'}, 'tipo': 'Unidade de Distribuição'}, 'urlIcone': '/public-resources/img/pre-atendimento-cor.png'}, {'codigo': 'RO', 'descricao': 'Objeto em trânsito - por favor aguarde', 'dtHrCriado': '2023-03-30T23:54:42', 'tipo': '01', 'unidade': {'endereco': {'cidade': 'BRASILIA', 'uf': 'DF'}, 'tipo': 'Unidade de Tratamento'}, 'unidadeDestino': {'endereco': {'cidade': 'BRASILIA', 'uf': 'DF'}, 'nome': 'CEE BRASILIA NORTE', 'tipo': 'CEE'}, 'urlIcone': '/public-resources/img/caminhao-cor.png'}, {'codigo': 'DO', 'descricao': 'Objeto em trânsito - por favor aguarde', 'dtHrCriado': '2023-03-30T03:31:03', 'tipo': '01', 'unidade': {'endereco': {'cidade': 'CAJAMAR', 'uf': 'SP'}, 'tipo': 'Unidade de Tratamento'}, 'unidadeDestino': {'endereco': {'cidade': 'BRASILIA', 'uf': 'DF'}, 'nome': 'CTE BRASILIA', 'tipo': 'CTE'}, 'urlIcone': '/public-resources/img/caminhao-cor.png'}, {'codigo': 'RO', 'descricao': 'Objeto em trânsito - por favor aguarde', 'dtHrCriado': '2023-03-29T09:24:26', 'tipo': '01', 'unidade': {'endereco': {'cidade': 'SAO PAULO', 'uf': 'SP'}, 'tipo': 'Agência dos Correios'}, 'unidadeDestino': {'endereco': {'cidade': 'CAJAMAR', 'uf': 'SP'}, 'nome': 'CTE CAJAMAR', 'tipo': 'CTE'}, 'urlIcone': '/public-resources/img/caminhao-cor.png'}, {'codigo': 'PO', 'descricao': 'Objeto postado', 'dtHrCriado': '2023-03-28T09:09:00', 'tipo': '01', 'unidade': {'endereco': {'cidade': 'SAO PAULO', 'uf': 'SP'}, 'tipo': 'Agência dos Correios'}, 'urlIcone': '/public-resources/img/agencia-cor.png'}], 'tipoPostal': {'categoria': 'ENCOMENDA PAC', 'descricao': 'ETIQUETA PAC (FÍSICA)', 'sigla': 'QC'}, 'habilitaAutoDeclaracao': False, 'permiteEncargoImportacao': False, 'habilitaPercorridaCarteiro': False, 'bloqueioObjeto': False, 'possuiLocker': False, 'habilitaLocker': False, 'habilitaCrowdshipping': False}], 'quantidade': 1, 'resultado': 'Todos os Eventos', 'versao': '2.4.10'}
{'objetos': [{'codObjeto': 'OV239461556BR', 'dtPrevista': '2023-03-09T20:59:59', 'eventos': [{'codigo': 'BDE', 'descricao': 'Objeto entregue ao destinatário', 'dtHrCriado': '2023-03-09T12:36:07', 'tipo': '01', 'unidade': {'endereco': {'cidade': 'CURITIBA', 'uf': 'PR'}, 'tipo': 'Unidade de Distribuição'}, 'urlIcone': '/public-resources/img/smile.png'}, {'codigo': 'OEC', 'descricao': 'Objeto saiu para entrega ao destinatário', 'dtHrCriado': '2023-03-09T09:14:41', 'tipo': '01', 'unidade': {'endereco': {'cidade': 'CURITIBA', 'uf': 'PR'}, 'tipo': 'Unidade de Distribuição'}, 'urlIcone': '/public-resources/img/pre-atendimento-cor.png'}, {'codigo': 'DO', 'descricao': 'Objeto em trânsito - por favor aguarde', 'dtHrCriado': '2023-03-09T07:28:23', 'tipo': '01', 'unidade': {'endereco': {'cidade': 'CURITIBA', 'uf': 'PR'}, 'tipo': 'Unidade de Tratamento'}, 'unidadeDestino': {'endereco': {'cidade': 'CURITIBA', 'uf': 'PR'}, 'nome': 'CDD UBERABA', 'tipo': 'CDD'}, 'urlIcone': '/public-resources/img/caminhao-cor.png'}, {'codigo': 'RO', 'descricao': 'Objeto em trânsito - por favor aguarde', 'dtHrCriado': '2023-03-08T20:36:49', 'tipo': '01', 'unidade': {'endereco': {'cidade': 'BRASILIA', 'uf': 'DF'}, 'tipo': 'Unidade de Tratamento'}, 'unidadeDestino': {'endereco': {'cidade': 'CURITIBA', 'uf': 'PR'}, 'nome': 'CTCE CURITIBA', 'tipo': 'TCE'}, 'urlIcone': '/public-resources/img/caminhao-cor.png'}, {'codigo': 'RO', 'descricao': 'Objeto em trânsito - por favor aguarde', 'dtHrCriado': '2023-03-08T15:55:19', 'tipo': '01', 'unidade': {'endereco': {'cidade': 'BRASILIA', 'uf': 'DF'}, 'tipo': 'Agência dos Correios'}, 'unidadeDestino': {'endereco': {'cidade': 'BRASILIA', 'uf': 'DF'}, 'nome': 'CTE BRASILIA', 'tipo': 'CTE'}, 'urlIcone': '/public-resources/img/caminhao-cor.png'}, {'codigo': 'PO', 'descricao': 'Objeto postado', 'dtHrCriado': '2023-03-08T15:09:51', 'tipo': '01', 'unidade': {'endereco': {'cidade': 'BRASILIA', 'uf': 'DF'}, 'tipo': 'Agência dos Correios'}, 'urlIcone': '/public-resources/img/agencia-cor.png'}], 'tipoPostal': {'categoria': 'SEDEX', 'descricao': 'ETIQUETA FISICA SEDEX OV', 'sigla': 'OV'}, 'habilitaAutoDeclaracao': False, 'permiteEncargoImportacao': False, 'habilitaPercorridaCarteiro': False, 'bloqueioObjeto': False, 'possuiLocker': False, 'habilitaLocker': False, 'habilitaCrowdshipping': False}], 'quantidade': 1, 'resultado': 'Todos os Eventos', 'versao': '2.4.10'}
{'objetos': [{'codObjeto': 'TE312430116BR', 'dtPrevista': '2023-02-06T20:59:59', 'eventos': [{'codigo': 'BDE', 'descricao': 'Objeto entregue ao destinatário', 'dtHrCriado': '2023-02-03T12:59:24', 'tipo': '01', 'unidade': {'endereco': {'cidade': 'CURITIBA', 'uf': 'PR'}, 'tipo': 'Unidade de Distribuição'}, 'urlIcone': '/public-resources/img/smile.png'}, {'codigo': 'OEC', 'descricao': 'Objeto saiu para entrega ao destinatário', 'dtHrCriado': '2023-02-03T09:25:42', 'tipo': '01', 'unidade': {'endereco': {'cidade': 'CURITIBA', 'uf': 'PR'}, 'tipo': 'Unidade de Distribuição'}, 'urlIcone': '/public-resources/img/pre-atendimento-cor.png'}, {'codigo': 'DO', 'descricao': 'Objeto em trânsito - por favor aguarde', 'dtHrCriado': '2023-02-03T07:45:10', 'tipo': '01', 'unidade': {'endereco': {'cidade': 'CURITIBA', 'uf': 'PR'}, 'tipo': 'Unidade de Tratamento'}, 'unidadeDestino': {'endereco': {'cidade': 'CURITIBA', 'uf': 'PR'}, 'nome': 'CDD UBERABA', 'tipo': 'CDD'}, 'urlIcone': '/public-resources/img/caminhao-cor.png'}, {'codigo': 'DO', 'descricao': 'Objeto em trânsito - por favor aguarde', 'dtHrCriado': '2023-02-02T20:29:20', 'tipo': '01', 'unidade': {'endereco': {'cidade': 'BELO HORIZONTE', 'uf': 'MG'}, 'tipo': 'Unidade de Tratamento'}, 'unidadeDestino': {'endereco': {'cidade': 'CURITIBA', 'uf': 'PR'}, 'nome': 'CTCE CURITIBA', 'tipo': 'TCE'}, 'urlIcone': '/public-resources/img/caminhao-cor.png'}, {'codigo': 'RO', 'descricao': 'Objeto em trânsito - por favor aguarde', 'dtHrCriado': '2023-02-01T15:48:18', 'tipo': '01', 'unidade': {'endereco': {'cidade': 'MARIANA', 'uf': 'MG'}, 'tipo': 'Agência dos Correios'}, 'unidadeDestino': {'endereco': {'cidade': 'BELO HORIZONTE', 'uf': 'MG'}, 'nome': 'CTCE BELO HORIZONTE', 'tipo': 'TCE'}, 'urlIcone': '/public-resources/img/caminhao-cor.png'}, {'codigo': 'PO', 'descricao': 'Objeto postado', 'dtHrCriado': '2023-02-01T14:34:10', 'tipo': '01', 'unidade': {'endereco': {'cidade': 'MARIANA', 'uf': 'MG'}, 'tipo': 'Agência dos Correios'}, 'urlIcone': '/public-resources/img/agencia-cor.png'}], 'tipoPostal': {'categoria': 'SEDEX', 'descricao': 'ETIQUETA LOGICA SEDEX', 'sigla': 'TE'}, 'habilitaAutoDeclaracao': False, 'permiteEncargoImportacao': False, 'habilitaPercorridaCarteiro': False, 'bloqueioObjeto': False, 'possuiLocker': False, 'habilitaLocker': False, 'habilitaCrowdshipping': False}], 'quantidade': 1, 'resultado': 'Todos os Eventos', 'versao': '2.4.10'}