---
title: "Deliver Collexus Return File"
method: POST
path: "/integrations/collexus/return-file/deliver"
tags: ["integrations", "collexus"]
---

# Deliver Collexus Return File

`POST /integrations/collexus/return-file/deliver`

## Request

- Base URL: `https://dev.whispa.net` (the document declares no server; this is the origin it was published from)
- URL: `https://dev.whispa.net/integrations/collexus/return-file/deliver`
- Auth: one of:
  - OAuth 2
    - Password
    - Token URL: `auth/bearer/login`
  - API key in cookie `access_token`

Upload one day's activity return file to the creditor's folder, once.

The scheduled delivery on request, for a chosen day and without waiting
for the delivery hour. It writes to the creditor's server, and a day is
delivered once: asking again for a delivered day sends nothing and says
so. It needs the scenario scope and a pinned host key, but not the daily
delivery switched on.

## Query parameters

- `business_date` string, date, nullable: Creditor-local day to deliver (see COLLEXUS_RETURN_FILE_TIMEZONE). Defaults to the most recent complete local day. A day that has not ended is refused.

## Response `200`

Successful Response

- CollexusReturnFileDeliveryResponse: One requested delivery, and what the ledger now says about that day.
  - `status` 'uploaded' | 'already_delivered' | 'confirmed' | 'adopted' | 'not_configured' | 'untrusted' | 'day_not_complete' | 'busy' | 'failed', required
  - `detail` string, required
  - `business_date` string, date, nullable
  - `filename` string, nullable
  - `remote_path` string, nullable
  - `row_count` integer, nullable
  - `byte_size` integer, nullable
  - `content_sha256` string, nullable
  - `delivered_at` string, date-time, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/whispa/apis/whispa-api.md) - [All operations](https://skmtc.dev/whispa/apis/whispa-api/llms.txt) - [OpenAPI document](https://skmtc.dev/whispa/apis/whispa-api/revisions/12c2e4aca43c?raw)