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

## Fields

| Field | Required | Type / allowed values |
| --- | --- | --- |
| `kind` | Yes | [RipsPackageKind](/reference/schemas/rips-package-kind/) |
| `origin` | No | `upload`, `guided` |
| `guidedContractVersion` | No | `1` |
| `rips` | No | [RipsDraftPayload](/reference/schemas/rips-draft-payload/) |
| `attachedDocument` | No | [AttachedDocumentInput](/reference/schemas/attached-document-input/) |
| `sourcePackageId` | No | string or null |
| `ripsSourceProfile` | No | `history`, `native-d558206`, `ministry-v003-20260715` |
| `ripsImportSource` | No | [RipsImportSource](/reference/schemas/rips-import-source/) |
| `inputProvenance` | No | [RipsInputProvenance](/reference/schemas/rips-input-provenance/) |

## JSON definition

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

```json
{
  "type": "object",
  "properties": {
    "kind": {
      "$ref": "#/components/schemas/RipsPackageKind"
    },
    "origin": {
      "type": "string",
      "enum": [
        "upload",
        "guided"
      ],
      "default": "upload",
      "description": "guided usa el contrato guiado del portal (perfil nativo); upload conserva la declaración de origen."
    },
    "guidedContractVersion": {
      "type": "number",
      "enum": [
        1
      ]
    },
    "rips": {
      "$ref": "#/components/schemas/RipsDraftPayload"
    },
    "attachedDocument": {
      "$ref": "#/components/schemas/AttachedDocumentInput"
    },
    "sourcePackageId": {
      "type": [
        "string",
        "null"
      ],
      "minLength": 1,
      "maxLength": 160,
      "pattern": "^[A-Za-z0-9._:-]+$",
      "description": "Paquete aceptado de referencia para notas de ajuste o débito."
    },
    "ripsSourceProfile": {
      "type": "string",
      "enum": [
        "history",
        "native-d558206",
        "ministry-v003-20260715"
      ]
    },
    "ripsImportSource": {
      "$ref": "#/components/schemas/RipsImportSource"
    },
    "inputProvenance": {
      "$ref": "#/components/schemas/RipsInputProvenance"
    }
  },
  "required": [
    "kind"
  ],
  "additionalProperties": false
}
```