Sende brev i Digipost med mulighet for fysisk print

Sending physical mail through Digipost

Hvis mottaker ikke er Digipost-bruker, kan man velge å sende brevet til fysisk print i stedet. Dette gjøres på følgende måte.

If the recipient is not a Digipost user yet, you can choose to send your letter as physical mail. The following shows how this is done.

Send brev med printinformasjon

Send letter with physical mail information (print details)

<?xml version="1.0" encoding="utf-8"?>
<message xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://api.digipost.no/schema/v8">
    <recipient>
        <name-and-address>
            <fullname>Hans Testson</fullname>
            <addressline1>Feil gate 16</addressline1>
            <postalcode>0573</postalcode>
            <city>Oslo</city>
        </name-and-address>
        <print-details>
            <recipient>
                <name>Hans Testson</name>
                <norwegian-address>
                    <addressline1>Testgate 1</addressline1>
                    <zip-code>1002</zip-code>
                    <city>Oslo</city>
                </norwegian-address>
            </recipient>
            <return-address>
                <name>Min bedrift</name>
                <norwegian-address>
                    <addressline1>Storgata 3</addressline1>
                    <zip-code>0102</zip-code>
                    <city>Oslo</city>
                </norwegian-address>
            </return-address>
            <post-type>B</post-type>
        </print-details>
    </recipient>
    <primary-document>
        <uuid>6d99008e-2672-4b55-9b09-996b09a06e47</uuid>
        <subject>simple-pdf-document</subject>
        <file-type>pdf</file-type>
        <authentication-level>PASSWORD</authentication-level>
        <sensitivity-level>NORMAL</sensitivity-level>
    </primary-document>
</message>

Hvis mottaker ikke kan identifiseres, enten fordi navn eller adresse er feil eller at personen ikke er Digipost-bruker, vil meldingen bli sendt til print, og adressene i print-details vil bli benyttet.

If the Digipost solution is not able to identify the recipient based on the information received, the letter will be printed and sent as physical mail. The information in print-details will be used to address physical mail.

Responsen vil indikere at meldingen er sendt til print.

The response will indicate that the letter will sent as physical mail.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<message-delivery xmlns="http://api.digipost.no/schema/v8">
    <delivery-method>PRINT</delivery-method>
    <sender-id>497013</sender-id>
    <status>DELIVERED_TO_PRINT</status>
    <delivery-time>2016-12-07T08:45:32.675+01:00</delivery-time>
    <primary-document>
        <uuid>6d99008e-2672-4b55-9b09-996b09a06e47</uuid>
        <subject>N/A</subject>
        <file-type>pdf</file-type>
        <pre-encrypt>false</pre-encrypt>
        <content-hash hash-algorithm="SHA256">5o0RMsXcgSZpGsL7FAmhSQnvGkqgOcvl5JDtMhXBSlc=</content-hash>
    </primary-document>
</message-delivery>

Alle dokumenter i kvitteringen vil få subject N/A ettersom dette ikke er relevant for brev som sendes til print.

Subject for all documents will be set to N/A since subject is only relevant when the document is delivered digitally.

Printdetaljer kan også kombineres med sending på Digipost-adresse og fødselsnummer

Print details can also be combined with personal identification number or Digipost address

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<message xmlns="http://api.digipost.no/schema/v5">
    ...
    <recipient>
        <digipost-address>hans.testson#1234</digipost-address>
        <print-details>
            ...
        </print-details>
    </recipient>
    ...
</message>

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<message xmlns="http://api.digipost.no/schema/v5">
    ...
    <recipient>
        <personal-identification-number>12345678909</personal-identification-number>
        <print-details>
            ...
        </print-details>
    </recipient>
    ...
</message>

Tilleggsfelter for sending på navn og adresse

Additional elements when identifying with name and address

Når man sender på navn og adresse, kan man øke sannsynligheten for å få finne mottakeren i Digipost ved å sende med fødselsdato og enten epostadresse eller telefonnummer eller begge.

When using name and address as identifying mechanism, you can increase the chance of getting the intended recipient identified in Digipost by including date of birth with either email address or telephone number (or both).

<name-and-address>
    <fullname>Hans Testson</fullname>
    <addressline1>Storgata 3</addressline1>
    <postalcode>0101</postalcode>
    <city>Oslo</city>
    <birth-date>1985-11-18</birth-date>
    <email-address>hans.testson@example.com</email-address>
    <phone-number>12345678</phone-number>
</name-and-address>