Submit a document for asynchronous issuance

POST

/companies/{companyId}/documents

curl --request POST \
  --url https://acme.gravitastec.com/api/v1/companies/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/documents \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: example' \
  --data '{ "ecfType": 31, "issueDate": "2026-04-15", "lines": [ {} ] }'

Authorizations

• oauth2

Parameters

Path Parameters

companyId

required

string format: uuid

Header Parameters

Idempotency-Key

required

string

<= 64 characters

Request Body^required

Canonical document model (R4 contracts/document-model.md). The full schema is generated from that model; unknown properties are rejected with 422 by the server.

object

ecfType

required

integer

Allowed values: 31 32 33 34 41 43 44 45 46 47

issueDate

required

string format: date

lines

required

Array<object>

>= 1 items

object

key

additional properties

any

Unsigned DGII e-CF XML without eNCF, FechaVencimientoSecuencia, FechaHoraFirma or Signature

string

Responses

200

Repeated idempotency key with the same payload; original result

Media typeapplication/json

object

documentId

required

string format: uuid

status

required

string

statusUrl

required

string

Example ^generated

{
  "documentId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
  "status": "example",
  "statusUrl": "example"
}

202

Accepted for processing

Media typeapplication/json

object

documentId

required

string format: uuid

status

required

string

statusUrl

required

string

Example ^generated

{
  "documentId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
  "status": "example",
  "statusUrl": "example"
}

Headers

Location

string

403

Production_not_enabled, quota denied (trial limit)

404

Not found or outside the credential scope

Media typeapplication/problem+json

object

type

string

title

string

status

integer

code

string

errors

Array<object>

object

path

string

message

string

Example ^generated

{
  "type": "example",
  "title": "example",
  "status": 1,
  "code": "example",
  "errors": [
    {
      "path": "example",
      "message": "example"
    }
  ]
}

409

Idempotency_conflict (same key

413

Payload too large

422

All validation errors with field paths; the document is not numbered

Media typeapplication/problem+json

object

type

string

title

string

status

integer

code

string

errors

Array<object>

object

path

string

message

string

Example ^generated

{
  "type": "example",
  "title": "example",
  "status": 1,
  "code": "example",
  "errors": [
    {
      "path": "example",
      "message": "example"
    }
  ]
}

429

Rate limit exceeded

Headers

Retry-After

integer