APEX AP Developer Portal — kompletní dokumentace API a SAPI endpointů.

{
  "timestamp": "2026-10-09T10:15:00.123",
  "status": 409,
  "error": "Conflict",
  "code": "IDEMPOTENCY_CONFLICT",
  "message": "Idempotency-Key 'FA2026-0001' was already used for a different request (document or routing metadata)",
  "path": "/api/v1/documents/send"
}

{
  "timestamp": "2026-10-09T19:31:24.544",
  "status": 401,
  "error": "Unauthorized",
  "message": "Missing or malformed Authorization: Bearer header",
  "path": "/api/v1/documents/send"
}

{
  "error": {
    "category": "AUTH",
    "code": "SAPI-AUTH-002",
    "message": "Access token is invalid or has expired",
    "details": null,
    "retryable": false,
    "correlation_id": "c3d4e5f6-a7b8-9012-cdef-345678901234"
  }
}

HTTP/1.1 429 Too Many Requests
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 0
Retry-After: 1

{
  "error": {
    "category": "TEMPORARY",
    "code": "SAPI-RATE-001",
    "message": "Rate limit exceeded. Maximum 100 requests per minute per IP address.",
    "retryable": true,
    "correlation_id": "f1a2b3c4-d5e6-7890-abcd-ef1234567890"
  }
}

curl -X POST "$APEX/api/v1/documents/send" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: FA2026-0001" \
  -d @faktura.json

{
  "senderParticipantId": "0245:2024000001",
  "receiverParticipantId": "0245:1234567890",
  "documentTypeId": "urn:oasis:names:specification:ubl:schema:xsd:Invoice-2::Invoice##urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:billing:3.0::2.1",
  "processId": "urn:fdc:peppol.eu:2017:poacc:billing:01:1.0",
  "ublDocument": "<?xml version=\"1.0\" encoding=\"UTF-8\"?><Invoice xmlns=\"urn:oasis:names:specification:ubl:schema:xsd:Invoice-2\" ...>...</Invoice>"
}

{
  "documentId": "550e8400-e29b-41d4-a716-446655440000",
  "status": "QUEUED",
  "submittedAt": "2026-10-09T10:30:00"
}

{
  "timestamp": "2026-10-09T10:30:00",
  "status": 400,
  "error": "Validation Error",
  "message": "Document validation failed: 1 error(s)",
  "validationErrors": [
    {
      "code": "BR-02",
      "message": "An Invoice shall have an Invoice number (BT-1).",
      "location": "/Invoice/cbc:ID"
    }
  ],
  "validationWarnings": []
}

{
  "networkReady": true,
  "valid": true,
  "participantExists": true,
  "canSend": true,
  "errors": [],
  "warnings": [
    {
      "category": "ROUTING",
      "code": "CERT_EXPIRING_SOON",
      "message": "Recipient AP certificate expires in 18 days (2026-10-27). Sending is still possible.",
      "location": null
    }
  ],
  "checkedAt": "2026-10-09T11:00:00+02:00"
}

{
  "networkReady": false,
  "valid": true,
  "participantExists": false,
  "canSend": false,
  "errors": [
    {
      "category": "PARTICIPANT",
      "code": "PARTICIPANT_NOT_FOUND",
      "message": "Participant '0245:9999999999' was not found in the Peppol network.",
      "location": null
    }
  ],
  "warnings": [],
  "checkedAt": "2026-10-09T11:00:00+02:00"
}

{
  "source": "SMP",
  "participantId": "iso6523-actorid-upis::0245:2024000001",
  "peppolId": "0245:2024000001",
  "organizationName": null,
  "countryCode": "SK",
  "endpointUrl": "https://ap.partner.example.com/as4/receive",
  "smpUrl": "https://smp.partner.example.com/",
  "enabled": true,
  "certificate": {
    "subject": "CN=PSK000202,OU=PEPPOL PRODUCTION AP,O=Partner SK s.r.o.,C=SK",
    "issuer": "CN=PEPPOL ACCESS POINT CA - G2,O=OpenPEPPOL AISBL,C=BE",
    "serial": "7f3a1b2c9d0e4f56",
    "fingerprint": "FF:EE:DD:CC:...:00",
    "notBefore": "2025-03-01T00:00:00Z",
    "notAfter": "2027-03-01T23:59:59Z",
    "expired": false,
    "valid": true,
    "invalidReason": null
  },
  "smpMetadataUpdatedAt": "2026-10-09T10:15:30Z"
}

[
  {
    "id": "d3a1e2f0-11aa-42bb-9c3d-000000000003",
    "messageId": "550e8400-e29b-41d4-a716-446655440000",
    "eventType": "MESSAGE_QUEUED",
    "eventCode": null,
    "eventMessage": "Document queued for async AS4 sending to https://receiver.example.com/as4",
    "technicalDetails": null,
    "stacktrace": null,
    "createdAt": "2026-10-09T10:30:01+02:00"
  },
  {
    "id": "d3a1e2f0-11aa-42bb-9c3d-000000000004",
    "messageId": "550e8400-e29b-41d4-a716-446655440000",
    "eventType": "QUEUE_PROCESSING_FAILED",
    "eventCode": null,
    "eventMessage": "Attempt 1/5 failed, retry in 30s: AS4 send returned failure",
    "technicalDetails": null,
    "stacktrace": null,
    "createdAt": "2026-10-09T10:30:04+02:00"
  },
  {
    "id": "d3a1e2f0-11aa-42bb-9c3d-000000000006",
    "messageId": "550e8400-e29b-41d4-a716-446655440000",
    "eventType": "MESSAGE_DELIVERED",
    "eventCode": null,
    "eventMessage": "Message delivered successfully",
    "technicalDetails": null,
    "stacktrace": null,
    "createdAt": "2026-10-09T10:30:40+02:00"
  }
]

{
  "name": "ERP Invoice Inbox",
  "description": "Notifikace o nových fakturách",
  "url": "https://erp.example.com/webhooks/peppol",
  "active": true,
  "documentTypeFilters": [
    "urn:oasis:names:specification:ubl:schema:xsd:Invoice-2::Invoice##urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:billing:3.0::2.1"
  ],
  "senderParticipantFilters": [],
  "customHeaders": { "X-Webhook-Secret": "sdilene-tajemstvi" }
}

POST https://erp.example.com/webhooks/peppol
Content-Type: application/json
User-Agent: Apex-Webhook/1.0
X-Webhook-Secret: sdilene-tajemstvi

{
  "eventType": "DOCUMENTS_RECEIVED",
  "subscriptionId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "documentId": "550e8400-e29b-41d4-a716-446655440001",
  "documentIds": ["550e8400-e29b-41d4-a716-446655440001"],
  "receivedCount": 1,
  "direction": "IN",
  "status": "VALIDATED",
  "messageId": "c3a1e7f2-5b9d-4d2e-8f41-2a6b9e0d7c15@sender-ap.example.com",
  "senderParticipantId": "iso6523-actorid-upis::0245:1234567890",
  "receiverParticipantId": "iso6523-actorid-upis::0245:2024000001",
  "documentTypeId": "urn:oasis:names:specification:ubl:schema:xsd:Invoice-2::Invoice##...::2.1",
  "processId": "urn:fdc:peppol.eu:2017:poacc:billing:01:1.0",
  "eventMessage": "Incoming Peppol document received",
  "notifiedAt": 1791282005.123456000
}

{
  "documentId": "550e8400-e29b-41d4-a716-446655440001",
  "senderParticipantId": "0245:1234567890",
  "receiverParticipantId": "0245:2024000001",
  "documentTypeId": "urn:oasis:names:specification:ubl:schema:xsd:Invoice-2::Invoice##...::2.1",
  "processId": "urn:fdc:peppol.eu:2017:poacc:billing:01:1.0",
  "receivedAt": "2026-10-09T09:15:00",
  "status": "VALIDATED",
  "ublDocument": "<StandardBusinessDocument xmlns=\"http://www.unece.org/cefact/namespaces/StandardBusinessDocumentHeader\"><StandardBusinessDocumentHeader>...</StandardBusinessDocumentHeader><Invoice xmlns=\"urn:oasis:names:specification:ubl:schema:xsd:Invoice-2\">...</Invoice></StandardBusinessDocument>"
}

curl -X POST "$APEX/api/v1/documents/inbox/550e8400-e29b-41d4-a716-446655440001/acknowledged" \
  -H "Authorization: Bearer $TOKEN"

HTTP/1.1 204 No Content

curl -X POST "$APEX/api/v1/batches" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: ERP-run-2026-10-09-17" \
  -H "Expect: 100-continue" \
  --data-binary @davka.json

{
  "clientReference": "ERP-run-2026-10-09-17",
  "notify": "BATCH",
  "documents": [
    {
      "clientReference": "FA2026-0001",
      "senderParticipantId": "0245:2024000001",
      "receiverParticipantId": "0245:1234567890",
      "documentTypeId": "urn:oasis:names:specification:ubl:schema:xsd:Invoice-2::Invoice##...::2.1",
      "processId": "urn:fdc:peppol.eu:2017:poacc:billing:01:1.0",
      "ublDocument": "<Invoice xmlns=\"urn:oasis:names:specification:ubl:schema:xsd:Invoice-2\">...</Invoice>"
    }
  ]
}

{
  "batchId": "6f1c2a9e-0b7d-4f3a-9c55-2b8e1f0d4a11",
  "clientReference": "ERP-run-2026-10-09-17",
  "status": "RECEIVED",
  "itemCount": 1000,
  "receivedAt": "2026-10-09T10:15:00Z"
}

{
  "eventType": "BATCH_PROCESSED",
  "subscriptionId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "eventMessage": "Batch processed: 990 accepted, 10 rejected, 0 cancelled",
  "notifiedAt": 1791281700.482913000,
  "batch": {
    "batchId": "6f1c2a9e-0b7d-4f3a-9c55-2b8e1f0d4a11",
    "clientReference": "ERP-run-2026-10-09-17",
    "status": "PROCESSED",
    "itemCount": 1000,
    "accepted": 990,
    "rejected": 10,
    "cancelled": 0
  }
}

POST /sapi/v1/document/send
Authorization: Bearer eyJhbGciOiJSUzI1NiIs...
Content-Type: application/json
Idempotency-Key: 3f6c1d2e-8a4b-4c5d-9e0f-112233445566
X-Peppol-Participant-Id: 0245:2024000001

{
  "metadata": {
    "documentId": "FA2026-0001",
    "documentTypeId": "urn:oasis:names:specification:ubl:schema:xsd:Invoice-2::Invoice##urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:billing:3.0::2.1",
    "processId": "urn:fdc:peppol.eu:2017:poacc:billing:01:1.0",
    "senderParticipantId": "0245:2024000001",
    "receiverParticipantId": "0245:1234567890",
    "creationDateTime": "2026-10-09T10:30:00Z"
  },
  "payload": "<?xml version=\"1.0\" encoding=\"UTF-8\"?><Invoice xmlns=\"urn:oasis:names:specification:ubl:schema:xsd:Invoice-2\" ...>...</Invoice>",
  "payloadFormat": "XML",
  "payloadEncoding": "UTF-8",
  "checksum": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855"
}

{
  "providerDocumentId": "7c9d0e1f-2a3b-4c5d-8e6f-0a1b2c3d4e5f",
  "status": "ACCEPTED",
  "receivedAt": "2026-10-09T08:30:05.123456Z",
  "timestamp": "2026-10-09T08:30:05.130Z"
}

{
  "status": "REJECTED",
  "timestamp": "2026-10-09T08:30:05Z",
  "errorCode": "RECEIVER_NOT_FOUND",
  "errorMessage": "The receiver is not registered in the Peppol network for this document type (The SML has no SMP address for the participant)",
  "error": {
    "category": "VALIDATION",
    "code": "SAPI-VAL-021",
    "message": "The receiver is not registered in the Peppol network for this document type (The SML has no SMP address for the participant)",
    "details": null,
    "retryable": false,
    "correlation_id": "e5f6a7b8-c9d0-1234-ef01-567890123456"
  }
}