Decodificador de DLR.

Um relatório de entrega é um relatório de estado que o SMSC envia de volta por SMPP num PDU deliver_sm, informando o destino final de uma mensagem submetida. O seu campo short_message segue o formato do Anexo B do SMPP v3.4, com campos como id, stat e err. Só chega se o tiver solicitado através de registered_delivery em submit_sm.

DELIVRD (message_state 2, DELIVERED) significa que a mensagem chegou ao terminal de destino e a rede confirmou-o. É o único valor stat que confirma a entrega ao terminal — um submit_sm_resp bem-sucedido por si só não o faz.

err é um código de erro curto, específico da rede ou do SMSC, que explica por que motivo uma mensagem falhou. O SMPP v3.4 não padroniza os seus valores, pelo que o significado exato depende do seu operador ou agregador. Um valor de 000 (ou 0) geralmente significa nenhum erro; procure qualquer valor diferente de zero na documentação do seu fornecedor.

DELIVRD, EXPIRED, DELETED, UNDELIV e REJECTD são finais — a mensagem não será reenviada. ACCEPTD e UNKNOWN não são finais: a mensagem ainda pode resolver-se noutro estado, por isso não os conte como entregues.

Alguns SMSC devolvem o message_id de submit_sm_resp em decimal e o id do DLR em hexadecimal (ou vice-versa), e agregadores intermédios podem reescrever os IDs por completo. Se não conseguir correlacioná-los diretamente, pergunte ao seu fornecedor qual representação utiliza, ou acompanhe a sua própria referência do lado do cliente.

Não. O ESME_ROK em submit_sm_resp confirma apenas que o SMSC aceitou a mensagem para processamento. A entrega final ao terminal é comunicada separadamente pelo DLR, que traz o seu próprio stat, como DELIVRD ou UNDELIV. Trate a aceitação do envio e a entrega como duas camadas distintas.

As sete palavras-chave e os respetivos números message_state são definidos pelo SMPP v3.4 e amplamente respeitados. No entanto, alguns SMSC emitem palavras-chave adicionais específicas do fornecedor ou reutilizam o campo text de forma diferente, pelo que deve confirmar sempre os casos limite na documentação de relatórios de entrega do seu fornecedor.