[All schemas](/reference/schemas/) · [API reference](/reference/) · [Data mapping guide](/guides/data-model/)

## Fields

| Field | Required | Type / allowed values |
| --- | --- | --- |
| `invoiceId` | Yes | string |
| `debitNoteResolutionId` | Yes | string |
| `discrepancyResponseCode` | Yes | [DebitNoteReasonCode](/reference/schemas/debit-note-reason-code/) |
| `discrepancyResponseDescription` | Yes | string |
| `debitNotePayload` | Yes | [DebitNotePayload](/reference/schemas/debit-note-payload/) |
| `rips` | Yes | [SupplementalDebitRips](/reference/schemas/supplemental-debit-rips/) |

## JSON definition

The JSON retains the source contract descriptions. Do not translate property names or enum values.

```json
{
  "type": "object",
  "properties": {
    "invoiceId": {
      "type": "string",
      "minLength": 1,
      "maxLength": 160,
      "pattern": "^[A-Za-z0-9._:-]+$",
      "description": "Identificador opaco."
    },
    "debitNoteResolutionId": {
      "type": "string",
      "minLength": 1,
      "maxLength": 160,
      "pattern": "^[A-Za-z0-9._:-]+$",
      "description": "Identificador opaco."
    },
    "discrepancyResponseCode": {
      "$ref": "#/components/schemas/DebitNoteReasonCode"
    },
    "discrepancyResponseDescription": {
      "type": "string",
      "minLength": 1,
      "maxLength": 500
    },
    "debitNotePayload": {
      "$ref": "#/components/schemas/DebitNotePayload"
    },
    "rips": {
      "$ref": "#/components/schemas/SupplementalDebitRips"
    }
  },
  "required": [
    "invoiceId",
    "debitNoteResolutionId",
    "discrepancyResponseCode",
    "discrepancyResponseDescription",
    "debitNotePayload",
    "rips"
  ],
  "additionalProperties": false,
  "description": "Emite una nota débito de salud a partir de una factura aceptada, con sus servicios RIPS adicionales. El importe no se limita por el saldo de notas crédito. Requiere datos adicionales explícitos; nunca reutiliza automáticamente los servicios facturados."
}
```