/v2/integration/deals

POST

Solicitud

Parámetros de Header

Parámetros del Body application/jsonRequerido

Ejemplos

Respuestas

🟢200OK

application/json

Body

🟠400Solicitud Incorrecta

🟠401No Autorizado

🟠404Registro No Encontrado

🔴500Error del Servidor

Ejemplo de Solicitud

Shell

JavaScript

Java

Swift

curl --location --request POST '/v2/integration/deals' \
--header 'x-api-key;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "batchId": "deal-batch-2025-08-26-001",
    "source": "crm-system-x",
    "items": [
        {
            "externalId": "D-1001",
            "title": "ACME Contract 2025",
            "ownerExternalId": "U-77",
            "agentExternalId": "SR-12",
            "isWon": false,
            "amount": {
                "value": "15000.00",
                "currency": "USD",
                "exchangeRate": "1.00"
            },
            "currentStage": {
                "pipelineName": "Sales pipeline 1",
                "value": "negotiation",
                "occurredAt": "2025-08-20T15:00:00Z"
            },
            "stages": [
                {
                    "pipelineName": "Sales pipeline 1",
                    "value": "lead",
                    "occurredAt": "2025-08-01T09:00:00Z"
                },
                {
                    "pipelineName": "Sales pipeline 2",
                    "value": "qualified",
                    "occurredAt": "2025-08-05T10:30:00Z"
                }
            ],
            "closeDate": null,
            "customFields": [
                {
                    "key": "region",
                    "type": "string",
                    "value": "EMEA",
                    "name": "Region"
                },
                {
                    "key": "priority",
                    "type": "number",
                    "value": 2,
                    "name": "Priority"
                }
            ]
        }
    ]
}'

Ejemplo de Respuesta

200 - Ejemplo 1

{
    "data": {
        "code": 201,
        "success": 100,
        "error": [
            {
                "message": "VALIDATION_ERROR",
                "detail": "Invalid currency code (ISO-4217)"
            }
        ]
    },
    "status": "SUCCESS"
}

Modificado en 2025-09-11 19:51:01

Manejo de errores

/v2/integration/deals