{"id":419,"date":"2023-11-23T11:17:20","date_gmt":"2023-11-23T10:17:20","guid":{"rendered":"http:\/\/localhost\/wordpress\/?page_id=419"},"modified":"2026-01-08T12:36:30","modified_gmt":"2026-01-08T12:36:30","slug":"recieving-delivery-reports","status":"publish","type":"page","link":"https:\/\/ip1sms.com\/en\/utvecklare\/leveransrapporter\/","title":{"rendered":"Receive delivery reports"},"content":{"rendered":"<div class=\"wp-block-columns is-layout-flex wp-container-core-columns-is-layout-9d6595d7 wp-block-columns-is-layout-flex\">\n<div class=\"wp-block-column p-5 is-layout-flow wp-block-column-is-layout-flow\" style=\"flex-basis:85%\">\n<div data-bs-spy=\"scroll\" data-bs-target=\"#developer-sub-menu\" data-bs-root-margin=\"0px 0px -40%\" data-bs-smooth-scroll=\"true\" tabindex=\"0\">\n\n\n\n<h1 class=\"wp-block-heading\" id=\"h-ta-emot-leveransrapporter\">Receive delivery reports<\/h1>\n\n\n\n<h2 class=\"wp-block-heading my-5\" id=\"h-beskrivning\">Description<\/h2>\n\n\n\n<p>If a delivery report URL has been specified when a batch is created, status update reports will be sent to that URL as soon as they are available. The contents of these reports are described below.<\/p>\n\n\n\n<p>Our system sends the report using&nbsp;<em>POST&nbsp;<\/em>and expects a&nbsp;<em>200 OK<\/em>&nbsp;response if the report is delivered correctly. If any other status (i. e. an error status) is received then the report will be sent again at a later time. These retries are repeated each 10 minutes until an&nbsp;<em>200 OK&nbsp;<\/em>is received, or for a maximum of 10 tries after which the report is discarded.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity Beskrivning\"\/>\n\n\n\n<h2 class=\"wp-block-heading my-5\" id=\"h-rapport-payload\">Payload Report<\/h2>\n\n\n\n<h3 class=\"wp-block-heading my-5\" id=\"h-exempel-pa-payload\">Example of payload<\/h3>\n\n\n<div class=\"wp-block-syntaxhighlighter-code\"><pre class=\"brush: csharp; title: ; notranslate\" title=\"\">\n{\n    \"id\": \"5c613848879973045cf39ac4\",\n    \"batchId\": \"5c613848879973045cf39ac3\",\n    \"recipient\": \"456189040623\",\n    \"code\": 102,\n    \"duration\": 0,\n    \"created\": \"2018-10-23T17:43:21Z\",\n    \"segments\": 2,\n    \"price\": 0.082,\n    \"currency\": \"sek\",\n    \"reference\": \"A client reference\"\n}\n<\/pre><\/div>\n\n\n<h3 class=\"wp-block-heading my-5\" id=\"h-falt-for-payload\">Fields for Payload<\/h3>\n\n\n\n<div class=\"responsive-table\">\n  <table class=\"table table-dark table-striped developer-table\">\n    <thead>\n      <tr>\n        <th>Field name<\/th>\n        <th>Type<\/th>\n        <th>Description and Conditions<\/th>\n        <th>Example<\/th>\n      <\/tr>\n    <\/thead>\n    <tbody>\n      <tr>\n        <td><strong>id<\/strong><\/td>\n        <td><code>String<\/code><\/td>\n        <td>\n          The ID of the incoming message.\n        <\/td>\n        <td>\n          <pre><code>\n\"id\": \"5bcf4324ee47dee41a9dbb13\"\n      <\/code><\/pre>\n        <\/td>\n      <\/tr>\n      <tr>\n        <td><strong>batchId<\/strong><\/td>\n        <td><code>String<\/code><\/td>\n        <td>\n          ID of the parent batch of the incoming message (Messages cannot exist without a parent\n          batch).\n        <\/td>\n        <td>\n          <pre><code>\n\"batchId\": \"5c613848879973045cf39ac3\"\n      <\/code><\/pre>\n        <\/td>\n      <\/tr>\n      <tr>\n        <td><strong>batchId<\/strong><\/td>\n        <td><code>String<\/code><\/td>\n        <td>\n          The account ID of the SMS account that owns the message (e.g. you).\n        <\/td>\n        <td>\n          <pre><code>\n\"owner\": \"ip1-XXXXX\"\n      <\/code><\/pre>\n        <\/td>\n      <\/tr>\n      <tr>\n        <td><strong>recipient<\/strong><\/td>\n        <td><code>String<\/code><\/td>\n        <td>\n          The sender ID of the message's originator.\n        <\/td>\n        <td>\n          <pre><code>\n\"sender\": \"46712345678\"\n      <\/code><\/pre>\n        <\/td>\n      <\/tr>\n      &lt;\/tr\n      <tr>\n        <td><strong>code<\/strong><\/td>\n        <td><code>Integer<\/code><\/td>\n        <td>\n        The most recent status code of the message. For more information on our status codes, see the section on <a href=\"\/en\/developer\/statuscodes\/\">Status codes<\/a>\n        <\/td>\n        <td>\n          <pre><code>\n\"code\": 102\n      <\/code><\/pre>\n        <\/td>\n      <\/tr>\n      <tr>\n        <td><strong>duration<\/strong><\/td>\n        <td><code>Integer<\/code><\/td>\n        <td>\n        Whether the status is permanent\/final. If it is, then this is the last report that will be sent about this message.\n        <\/td>\n        <td>\n          <pre><code>\n\"duration: 0\n      <\/code><\/pre>\n        <\/td>\n      <\/tr>\n      <tr>\n        <td><strong>created<\/strong><\/td>\n        <td><code>String<\/code><\/td>\n        <td>\n          When the status update occured (i. e. when the report was generated).\n        <\/td>\n        <td>\n          <pre><code>\n\"created\": \"2018-10-23T17:43:21Z\"\n      <\/code><\/pre>\n        <\/td>\n      <\/tr>\n      <tr>\n        <td><strong>segments<\/strong><\/td>\n        <td><code>String<\/code><\/td>\n        <td>\n          In cases where the message consists of more characters than the character limit for one SMS, the message will be split into several SMS, also called concatenated SMS. This property indicates how many SMS are needed to send the message\n        <\/td>\n        <td>\n          <pre><code>\n\"segments\": 2,\n      <\/code><\/pre>\n        <\/td>\n      <\/tr>\n      <tr>\n        <td><strong>price<\/strong><\/td>\n        <td><code>Integer<\/code><\/td>\n        <td>\n        The price for the entire message. In case you want to get the price for a single sms you can divide the number of segments by the price.\n        <\/td>\n        <td>\n          <pre><code>\n\"price\": 0.082,\n      <\/code><\/pre>\n        <\/td>\n      <\/tr>\n      <tr>\n        <td><strong>currency<\/strong><\/td>\n        <td><code>String<\/code><\/td>\n        <td>\n        Which currency the given price uses.\n        <\/td>\n        <td>\n          <pre><code>\n\"currency\": \"sec\",\n      <\/code><\/pre>\n        <\/td>\n      <\/tr>\n      <tr>\n        <td><strong>reference<\/strong><\/td>\n        <td><code>String<\/code><\/td>\n        <td>\n        This is a property that allows the user to set a custom ID or credential if storing the default generated IDs is deprecated.\n        <\/td>\n        <td>\n          <pre><code>\n \"reference\": \"A client reference\"\n      <\/code><\/pre>\n        <\/td>\n      <\/tr>\n    <\/tbody>\n  <\/table>\n<\/div>\n\n\n\n<\/div>\n\n\n\n<script type=\"application\/ld+json\">{\n    \"@context\": \"https:\\\/\\\/schema.org\",\n    \"@type\": \"Service\",\n    \"name\": \"iP.1 SMS API Specifikation f\\u00f6r Leveransrapporter (Callback)\",\n    \"serviceType\": \"Rapportering och Leveransstatus\",\n    \"description\": \"Dokumentation som specificerar det format och protokoll som IP.1 anv\\u00e4nder f\\u00f6r att skicka realtidsrapporter om SMS-leveransstatus till kundens Callback URL. Konfiguration av adressen sker via v\\u00e5r webbportal, inte via API.\",\n    \"url\": \"https:\\\/\\\/ip1sms.com\\\/utvecklare\\\/leveransrapporter\\\/\",\n    \"provider\": {\n        \"@type\": \"Organization\",\n        \"name\": \"iP.1 Networks AB\",\n        \"url\": \"https:\\\/\\\/ip1sms.com\\\/\"\n    },\n    \"serviceOutput\": {\n        \"@type\": \"CreativeWork\",\n        \"name\": \"Leveransrapport Datastruktur\",\n        \"description\": \"Specifikation av de JSON-f\\u00e4lt och HTTP-metoder som IP.1 anv\\u00e4nder vid utskick av leveransrapporter till kundens server.\"\n    }\n}<\/script>\n<\/div>\n\n\n\n<div class=\"wp-block-column is-layout-flow wp-block-column-is-layout-flow\" style=\"flex-basis:15%\">\n<nav id=\"developer-sub-menu\" class=\"navbar sticky-top\">\n    <nav class=\"nav bg-light flex-column\">\n        <a class=\"nav-link font-weight-bold\" href=\"#h-ta-emot-leveransrapporter\">Delivery reports<\/a>\n        <nav class=\"nav\">\n            <a class=\"nav-link text-muted\" href=\"#h-beskrivning\">Description<\/a>\n        <\/nav>\n        <a class=\"nav-link font-weight-bold\" href=\"#h-rapport-payload\">Payload reports<\/a>\n        <nav class=\"nav\">\n            <a class=\"nav-link text-muted\" href=\"#h-exempel-pa-payload\">Example of payload<\/a>\n            <a class=\"nav-link text-muted\" href=\"#h-falt-for-payload\">Fields for payload<\/a>\n        <\/nav>\n    <\/nav>\n<\/nav>\n<\/div>\n<\/div>","protected":false},"excerpt":{"rendered":"<p>Ta emot leveransrapporter Beskrivning Om en URL f\u00f6r leveransrapporter har angets n\u00e4r en batch skapas, kommer rapporter \u00f6ver statusuppdateringar att skickas till den URL s\u00e5 fort de finns tillg\u00e4ngliga. Inneh\u00e5llet i dessa rapporter \u00e4r beskrivna nedan. Systemet skickar ut rapporter genom metoden&nbsp;POST&nbsp;och f\u00f6rv\u00e4ntar sig ett&nbsp;200 OK&nbsp;i respons om rapporten tagits emot korrekt. Om n\u00e5gon responsen [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":0,"parent":382,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"developer.php","meta":{"footnotes":""},"categories":[4],"tags":[26],"class_list":["post-419","page","type-page","status-publish","hentry","category-api-dokumention","tag-sms"],"_links":{"self":[{"href":"https:\/\/ip1sms.com\/en\/wp-json\/wp\/v2\/pages\/419","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/ip1sms.com\/en\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/ip1sms.com\/en\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/ip1sms.com\/en\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/ip1sms.com\/en\/wp-json\/wp\/v2\/comments?post=419"}],"version-history":[{"count":0,"href":"https:\/\/ip1sms.com\/en\/wp-json\/wp\/v2\/pages\/419\/revisions"}],"up":[{"embeddable":true,"href":"https:\/\/ip1sms.com\/en\/wp-json\/wp\/v2\/pages\/382"}],"wp:attachment":[{"href":"https:\/\/ip1sms.com\/en\/wp-json\/wp\/v2\/media?parent=419"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/ip1sms.com\/en\/wp-json\/wp\/v2\/categories?post=419"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/ip1sms.com\/en\/wp-json\/wp\/v2\/tags?post=419"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}