Skip to content

Resolve import conflict

POST
/api/v1/tenants/{tenant_id}/workspaces/{workspace_id}/invoices/import/conflicts/{conflict_id}/resolve

Resolve import conflict by renaming invoice number or skipping conflict.

conflict_id
required
Conflict Id
string format: uuid
X-Workspace-ID
Any of:
string
X-API-Key
Any of:
string
X-Tenant-ID
Any of:
string
InvoiceImportConflictResolveRequest

Resolve import conflict queue item.

object
action
required
Action
string
/^(rename|skip)$/
new_invoice_number
Any of:
string
<= 200 characters
note
Any of:
string
Examples

Request payload example

{
"action": "string",
"new_invoice_number": "string",
"note": "string"
}

Successful Response

InvoiceImportConflictResponse

Invoice import conflict queue response.

object
created_at
required
Created At
string format: date-time
updated_at
required
Updated At
string format: date-time
id
required
Id
string format: uuid
tenant_id
required
Tenant Id
string format: uuid
workspace_id
Any of:
string format: uuid
invoice_id
Any of:
string format: uuid
source_system
Any of:
string
source_invoice_id
Any of:
string
requested_invoice_number
Any of:
string
assigned_invoice_number
Any of:
string
conflict_type
required
InvoiceImportConflictType

Kinds of import conflicts tracked for finance review.

string
Allowed values: invoice_number_conflict source_identity_conflict irn_conflict
status
required
InvoiceImportConflictStatus

Conflict queue status.

string
Allowed values: open resolved skipped
details
Any of:
object
key
additional properties
any
resolved_at
Any of:
string format: date-time
resolved_by
Any of:
string format: uuid
resolution_action
Any of:
string
resolution_note
Any of:
string
Examples

200 response example

{
"created_at": "2026-02-11T10:00:00Z",
"updated_at": "2026-02-11T10:00:00Z",
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"tenant_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"workspace_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"invoice_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"source_system": "string",
"source_invoice_id": "string",
"conflict_type": "invoice_number_conflict",
"status": "open"
}

Validation Error

HTTPValidationError
object
detail
Detail
Array<object>
ValidationError
object
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string
Examples

422 response example

{
"detail": [
{
"loc": [],
"msg": "string",
"type": "string"
}
]
}