Frequently Asked Questions

SMS poštar (Push SMS Service)

1. I'm using PHP SDK tool for SMS/MMS Poštar. Which certificate do I have to use?

Use the certificate ending with pem.

2. I'm using SMS/MMS PUSH SDK tool for Windows. Which certificate do I have to use?

Use the certificate ending with pfx.

3. I've received a certificate from Mobitel and have installed the SSL link. When I send the PD XML package to Mobitel, I receive a server reply »unregistered certificate name«. What does it mean?

This means your certificate has not been registered in the Mobitel SMS Poštar system or the registration is invalid.
What to do: Contact help@m-vrata.com and send CN (Common Name) of your SSL certificate, so we can validate the registration.

4. I've created a PD package and have sent it to Mobitel server. I've received a reply: »file corrupted«.

Answer: You've sent an invalid PD package or an empty http request.
What to do: Validate XML package structure and/or sending mode (POST request).

5. I've created a PD package and have sent it to Mobitel server. I've received a reply: »Duplicated Packet ID«.

Answer: A package with this ID already exists on Mobitel SMS Poštar system. The package with the same ID has already been sent to Mobitel, or has been sent by somebody else.
What to do: We suggest to use GUID policy (globally unique identifier) for ID. If you do not apply GUID, compose your ID of as many letters and digits as possible (max 50 characters).

6. Can I use the UNICODE character set?

Answer: You can't use the UNICODE character set. You can only use the upper and lower part of ISO-8859-1 (please see question n. 7).

7. Can I use other characters, such as symbols for foreign currencies, jen (¥), dollar ($), British pound (£) and euro (€)?

Answer: The symbol for euro (€) is not included into ISO-8859-1, and unfortunately it can't be used. You can use all symbols of ISO-8859-1 (code od 0 do 127), which represent the original 7-BIT ASCII standard. You can also use most of the upper part of ISO-8859-1, using codes from 128 to 255. The characters must be appropriately encoded in XML (e.g. symbol ¥ in XML is replaced by the code ¥).

8. I've requested the delivery information using: <DeliveryNotificationRequest>1</DeliveryNotificationRequest>. After examining the statuses I realized all messages had Status 1, regardless of being actually delivered or not.

Answer: The option for sending/receiving delivery information in your certificate is not on.
What to do: Contact help@m-vrata.com and send CN (Common Name) of your SSL certificate to enable the delivery-information option.

9. What's the difference between OK status packet and OK PDStatusResponse packet?

Answer: As soon as SMS Poštar has received the PD packet, it replies with OK status packet. It carries information about successfully received numbers by Mobitel server and confirmed by the messaging procedure. OK status packet is only received once. After that Mobitel server forwards SMS messages to the system for SMS messaging or the SMS centre. Either of these sends a delivery confirmation for each message. SMS Poštar keeps delivery confirmations and these can be retrieved anytime (send PDStatus Request packet to retrieve delivery confirmations).

10. How often do we request delivery confirmations?

Answer: It is recommended to request delivery confirmations while delivery status changes are still likely to occur. If a tag <IsDeliveryComplete>1</IsDeliveryComplete> has value 1, delivery-status changes are not expected. Undelivered messages will remain undelivered permanently, statuses of all messages in the package are permanent.

11. Can I bill a received SMS message also to a Simobil user?

Answer: SMS messages can be billed to Mobitel users. Other GSM users can only receive non-premium SMS messages (do not contain any billing information).

12. Mobile numbers are portable (e. g. from Simobil to Mobitel). How do I know the operator of a certain number?

Answer: If you send billing information to a GSM user, who is not a Mobitel user, you receive error information in OK Status Reponse packet: [24]Unknown MSISDN.
What to do: Service provider must delete such users from the database.

PHP SDK

13. How do I add billing information to PD XML package to bill SMS messages to addressees?

Answer: If you wish to bill all users the same rates (category), then billing parameters must be entered inside the tag <Header>, as follows :

$sms_to_send->setBillingAmount('10000');
$sms_to_send->setBillingDesc('category description');
$sms_to_send->setProviderId('2104');
$sms_to_send->setBillingCat('1');
$sms_to_send->setServiceId('34');
$sms_to_send->setBillingTax('20');
$sms_to_send->setDeliveryNotReq('1');

14. How do I activate the request for confirmation delivery?

Answer: You can activate confirmation delivery by adding the following line:

$sms_to_send->setDeliveryNotReq('1');