POST/api/v1/workspaces/{workspaceId}/credit-notes
**Operation ID:** `creditNotes.emit` · **Access:** PAT with `send` scope and authorized workspace where applicable · **Effect:** `external`.
:::caution[Production action]
This operation can send data to an external service. Use a new idempotency key for each new intent. A timeout does not prove that the action failed.
:::
An `Idempotency-Key` is **required**. Retry the same intent with the same key and the same request bytes. [Read the retry rules](/guides/errors-and-retries/).
Read the [credit notes workflow](/guides/health-documents/) before this operation.
## Parameters
| Name | In | Required | Type / allowed values |
| --- | --- | --- | --- |
| `workspaceId` | path | Yes | string |
| `idempotency-key` | header | Yes | string |
## Request body
**Content type:** `application/json` · **Required:** yes.
Schema: [EmitCreditNoteInput](/reference/schemas/emit-credit-note-input/). [Browse schema fields](/reference/schemas/).
Example: partial
Synthetic contract example. Replace identifiers and clinical data with authorized values. This example does not prove ministry acceptance.
[Download JSON](/examples/credit-notes-emit-partial.json)
```json
{
"invoiceId": "invoice-demo-001",
"creditNoteResolutionId": "credit-resolution-demo-001",
"discrepancyResponseCode": 1,
"discrepancyResponseDescription": "Devolución de servicio (ejemplo sintético)",
"selectedItems": [
{
"patientConsecutivo": 1,
"includeAllServices": false,
"selectedServices": [
{
"serviceCategory": "consultas",
"serviceConsecutivo": 1
}
]
}
],
"creditNotePayload": {
"credit_note_lines": [
{
"description": "Consulta de medicina general (ejemplo sintético)",
"code": "890201",
"invoiced_quantity": "1",
"price_amount": "100000.00",
"line_extension_amount": "100000.00"
}
],
"legal_monetary_totals": {
"line_extension_amount": "100000.00",
"tax_exclusive_amount": "100000.00",
"tax_inclusive_amount": "100000.00",
"payable_amount": "100000.00"
}
}
}
```
Example: total
Synthetic contract example. Replace identifiers and clinical data with authorized values. This example does not prove ministry acceptance.
[Download JSON](/examples/credit-notes-emit-total.json)
```json
{
"invoiceId": "invoice-demo-001",
"creditNoteResolutionId": "credit-resolution-demo-001",
"discrepancyResponseCode": 2,
"discrepancyResponseDescription": "Anulación total (ejemplo sintético)",
"creditNotePayload": {
"credit_note_lines": [
{
"description": "Consulta de medicina general (ejemplo sintético)",
"code": "890201",
"invoiced_quantity": "1",
"price_amount": "100000.00",
"line_extension_amount": "100000.00"
}
],
"legal_monetary_totals": {
"line_extension_amount": "100000.00",
"tax_exclusive_amount": "100000.00",
"tax_inclusive_amount": "100000.00",
"payable_amount": "100000.00"
}
}
}
```
## Responses
| HTTP | Content | Schema |
| --- | --- | --- |
| 201 | `application/json` | [CreditNote](/reference/schemas/credit-note/) |
| 202 | `application/json` | [CreditNote](/reference/schemas/credit-note/) |
| 400 | `application/json` | [ApiError](/reference/schemas/api-error/) |
| 401 | `application/json` | [ApiError](/reference/schemas/api-error/) |
| 403 | `application/json` | [ApiError](/reference/schemas/api-error/) |
| 404 | `application/json` | [ApiError](/reference/schemas/api-error/) |
| 409 | `application/json` | [ApiError](/reference/schemas/api-error/) |
| 413 | `application/json` | [ApiError](/reference/schemas/api-error/) |
| 415 | `application/json` | [ApiError](/reference/schemas/api-error/) |
| 422 | `application/json` | [ApiError](/reference/schemas/api-error/) |
| 428 | `application/json` | [ApiError](/reference/schemas/api-error/) |
| 500 | `application/json` | [ApiError](/reference/schemas/api-error/) |
| 502 | `application/json` | [ApiError](/reference/schemas/api-error/) |
| 503 | `application/json` | [ApiError](/reference/schemas/api-error/) |
Use `error.code`, `error.issues`, and `requestId` for JSON errors. [Error and recovery guide](/guides/errors-and-retries/).
## cURL
Set the connection variables from the [quickstart](/guides/quickstart/). Set each path variable to an authorized identifier or an allowed parameter value from the table above.
Save your authorized JSON input as `request.json`. Use the request schema and examples above; replace synthetic data before use.
Set `IDEMPOTENCY_KEY` to a unique key for this intent. Preserve it and the exact request for retries.
```bash
curl --fail-with-body --request POST \
"$RIPSCLOUD_BASE_URL/api/v1/workspaces/$WORKSPACE_ID/credit-notes" \
--header "Authorization: Bearer $RIPSCLOUD_TOKEN" \
--header 'Accept: application/json' \
--header "Idempotency-Key: $IDEMPOTENCY_KEY" \
--header 'Content-Type: application/json' \
--data-binary @request.json
```