Skip to content
Invogi Docs

Submit a completed FA(3) XML invoice with a current PASS decision (ADMIN+)

POST
/ksef-connections/{connectionId}/submissions
curl --request POST \
  --url https://api.invogi.com/v1/ksef-connections/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/submissions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "invoice_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0" }'

Idempotent per connection and invoice. Persisted KSeF references are resumed after transient failures rather than sent twice.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
connectionId
required
string format: uuid

Request Bodyrequired

Section titled “Request Bodyrequired”
Media typeapplication/json
object
invoice_id
required
string format: uuid

Example generated

{
  "invoice_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0"
}

Responses

Section titled “Responses”

200

Section titled “200”

Existing or synchronously completed submission

Media typeapplication/json
object
id
required
string format: uuid
companyId
required
string format: uuid
connectionId
required
string format: uuid
invoiceId
required
string format: uuid
status
required
string
Allowed values: QUEUED SUBMITTING ACCEPTED REJECTED FAILED
sessionReferenceNumber
required
string | null
invoiceReferenceNumber
required
string | null
ksefNumber
required
string | null
upoReferenceNumber
required
string | null
errorCode
required
string | null
errorMessage
required
string | null
submittedAt
required
string | null format: date-time
completedAt
required
string | null format: date-time
createdAt
required
string format: date-time
updatedAt
required
string format: date-time

Example 

{
  "status": "QUEUED"
}

202

Section titled “202”

Submission queued

Media typeapplication/json
object
id
required
string format: uuid
companyId
required
string format: uuid
connectionId
required
string format: uuid
invoiceId
required
string format: uuid
status
required
string
Allowed values: QUEUED SUBMITTING ACCEPTED REJECTED FAILED
sessionReferenceNumber
required
string | null
invoiceReferenceNumber
required
string | null
ksefNumber
required
string | null
upoReferenceNumber
required
string | null
errorCode
required
string | null
errorMessage
required
string | null
submittedAt
required
string | null format: date-time
completedAt
required
string | null format: date-time
createdAt
required
string format: date-time
updatedAt
required
string format: date-time

Example 

{
  "status": "QUEUED"
}

400

Section titled “400”

Invalid request

Media typeapplication/json
object
error
required
object
code
required
string
Allowed values: NOT_FOUND UNAUTHORIZED FORBIDDEN INVALID_REQUEST CONFLICT RATE_LIMITED USAGE_LIMIT_EXCEEDED PROCESSING_FAILED
message
required
string
request_id
required
string

Example 

{
  "error": {
    "code": "NOT_FOUND"
  }
}

401

Section titled “401”

Missing or invalid API key

Media typeapplication/json
object
error
required
object
code
required
string
Allowed values: NOT_FOUND UNAUTHORIZED FORBIDDEN INVALID_REQUEST CONFLICT RATE_LIMITED USAGE_LIMIT_EXCEEDED PROCESSING_FAILED
message
required
string
request_id
required
string

Example 

{
  "error": {
    "code": "NOT_FOUND"
  }
}

403

Section titled “403”

API key lacks required scope/role

Media typeapplication/json
object
error
required
object
code
required
string
Allowed values: NOT_FOUND UNAUTHORIZED FORBIDDEN INVALID_REQUEST CONFLICT RATE_LIMITED USAGE_LIMIT_EXCEEDED PROCESSING_FAILED
message
required
string
request_id
required
string

Example 

{
  "error": {
    "code": "NOT_FOUND"
  }
}

404

Section titled “404”

Resource not found

Media typeapplication/json
object
error
required
object
code
required
string
Allowed values: NOT_FOUND UNAUTHORIZED FORBIDDEN INVALID_REQUEST CONFLICT RATE_LIMITED USAGE_LIMIT_EXCEEDED PROCESSING_FAILED
message
required
string
request_id
required
string

Example 

{
  "error": {
    "code": "NOT_FOUND"
  }
}

409

Section titled “409”

Conflicting idempotency key or resource processing state

Media typeapplication/json
object
error
required
object
code
required
string
Allowed values: NOT_FOUND UNAUTHORIZED FORBIDDEN INVALID_REQUEST CONFLICT RATE_LIMITED USAGE_LIMIT_EXCEEDED PROCESSING_FAILED
message
required
string
request_id
required
string

Example 

{
  "error": {
    "code": "NOT_FOUND"
  }
}