デジタルインボイスの受領

注記

デジタルインボイスの書式は「Peppol仕様書」 をご参照ください。

デジタルインボイスの受領には2つの方法があります。 1つは、Peppol ConnectのAPIを使って受信する方法、もう1つはWebhookを使って受信する方法です。

Peppol Connect APIを利用する

POST /v2/receive_documents/xml_invoice

$ curl -X POST https://api.e-invoice.moneyforward.com/v2/receive_documents/xml_invoice \
    -d '@body.json'

body.json

{
    "participant_id": "0188:0000000000000",
    "received_at": "2023-01-01T00:00:00Z"
}

受信に成功すると、以下のようにレスポンスが返却されます。

<ReceivedInvoices>
    <Invoice>
        <Payload>
            <Invoice>
                <!-- Please refer to Peppol specification at the top for details -->
            </Invoice>
        </Payload>
        <MessageID>082597d4-5108-482b-b0b3-11844de562c7</MessageID>
        <ReceivedAt>2023-01-01T00:00:00Z</ReceivedAt>
        <SenderParticipantID>0188:0000000000001</SenderParticipantID>
        <ReceiverParticipantID>0188:0000000000002</ReceiverParticipantID>
    </Invoice>
</ReceivedInvoices>

Webhookを利用する

Peppol Connectでは、Webhookを通じてPeppolで受領したデジタルインボイスを受け取ることができます。 Peppol Connect管理画面からWebhook URLを登録することで、Peppolで受領したデジタルインボイスを任意のURLで受け取ることができます。 この機能は現在開発中ですが、下記のような機能を含めることを予定しています。

• HMAC認証: データ改ざんの検知やなりすまし防止のために署名をヘッダーに添付して送信し、受け取ったリクエストを検証することができます。
• リクエストの形式: Webhookイベントの受信側で受け取るデータには、デジタルインボイス情報そのものではなく、 それぞれのインボイスが持っているユニークなIDであるMessage IDを含めることを予定しています。