Jedno żądanie dodaje do kolejki wysyłkę wielu faktur. Wynik dla każdej faktury sprawdza się osobno, tak jak przy pojedynczej wysyłce.
Wymagania
- Klucz API z zakresem
api:invoices:writew zmiennejINFAKT_API_KEY. - Lista
uuidfaktur do wysłania.
Kroki
Wysłanie faktur
curl -X POST "https://api.sandbox-infakt.pl/v3/ksef2/documents/send.json" \ -H "X-inFakt-ApiKey: $INFAKT_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "uuids": [ "9bdc76fd-7a02-42ec-a4a3-42bc867b9a9f", "0be870f9-aa52-4d0f-a9ff-994e374ecff0" ] }'const res = await fetch("https://api.sandbox-infakt.pl/v3/ksef2/documents/send.json", { method: "POST", headers: { "X-inFakt-ApiKey": process.env.INFAKT_API_KEY, "Content-Type": "application/json", }, body: JSON.stringify({ "uuids": [ "9bdc76fd-7a02-42ec-a4a3-42bc867b9a9f", "0be870f9-aa52-4d0f-a9ff-994e374ecff0" ] }), }); const data = await res.json(); console.log(res.status, data);import os import requests res = requests.post( "https://api.sandbox-infakt.pl/v3/ksef2/documents/send.json", headers={"X-inFakt-ApiKey": os.environ["INFAKT_API_KEY"]}, json={ "uuids": [ "9bdc76fd-7a02-42ec-a4a3-42bc867b9a9f", "0be870f9-aa52-4d0f-a9ff-994e374ecff0" ] }, ) print(res.status_code, res.json())<?php $ch = curl_init('https://api.sandbox-infakt.pl/v3/ksef2/documents/send.json'); curl_setopt_array($ch, [ CURLOPT_CUSTOMREQUEST => 'POST', CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => [ 'X-inFakt-ApiKey: ' . getenv('INFAKT_API_KEY'), 'Content-Type: application/json', ], CURLOPT_POSTFIELDS => json_encode([ 'uuids' => ['9bdc76fd-7a02-42ec-a4a3-42bc867b9a9f', '0be870f9-aa52-4d0f-a9ff-994e374ecff0'], ]), ]); $response = curl_exec($ch); $status = curl_getinfo($ch, CURLINFO_HTTP_CODE); echo $status, ' ', $response, PHP_EOL;Sprawdzenie odrzuconych faktur
Kod
200oznacza, że przyjęto wszystkie faktury. Kod207oznacza, że część z nich odrzucono; odrzucone faktury mają"status": "rejected"i"request_uuid": null. Kod404oznacza, że żaden z podanychuuidnie odpowiada fakturze na tym koncie.Odbiór wyników
Wynik każdej przyjętej faktury przychodzi w webhooku albo w odpowiedzi
GET /ksef2/documents/{uuid}/status.json, tak jak w poradniku Wysyłka faktury do KSeF.
Weryfikacja
Każdy element entities zawiera invoice_uuid i status. Status przyjętych faktur zmienia się z pending na sent, a następnie na success lub error.