SIFENDE
ReferenciaApi

Nominar el receptor de una factura innominada

Nominación síncrona B2B/B2C/B2F. La consulta de confirmación y, si se confirma ausencia, como máximo un reenvío ocurren dentro de esta petición. Un resultado incierto conserva ENVIADO y responde 503 con Retry-After; no equivale a aprobación ni rechazo y no inicia recuperación en segundo plano. Sólo APROBADO aporta el receptor efectivo para la precarga de NCE/NDE en el panel. El XML firmado, CDC y KuDE originales no se modifican. Idempotency-Key es opcional, con alcance por contribuyente y ambiente compartido entre operaciones. Una clave existente recupera el documento, motivo y receptor originales, sin comparar el body ni el CDC posterior, incluso si el documento quedó archivado. Otro tipo de operación devuelve 422. Persistí la clave y la solicitud original; usá una clave nueva para cada intención nueva. El replay dura 7 días desde la finalización. La clave sigue reservada después, hasta que termina la conservación del documento. El body debe poder deserializarse; sus campos se validan sólo para operaciones nuevas. SANDBOX responde 422 sin registrar ni enviar un evento.

POST
/api/v1/documento-electronico/{cdc}/nominar
AuthorizationBearer <token>

API key de Sifende en el header Authorization: Bearer {api-key}. Además de autenticar, fija el contribuyente emisor y un ambiente inmutable DEV, PROD o SANDBOX: por eso ninguno de los dos se envía en el body.

In: header

Path Parameters

cdc*string

Header Parameters

Idempotency-Key?string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Datos necesarios para nominar el receptor de una factura electrónica innominada

Response Body

*/*

curl -X POST "https://example.com/api/v1/documento-electronico/string/nominar" \  -H "Content-Type: application/json" \  -d '{    "receptor": {      "naturaleza": "CONTRIBUYENTE",      "tipoOperacion": "B2B",      "pais": "DZA",      "nombreRazonSocial": "string"    },    "motivo": "string"  }'
{  "eventoSifenId": 0,  "documentoElectronicoId": 0,  "contribuyenteId": 0,  "ambiente": "string",  "tipoEvento": "string",  "estadoEvento": "string",  "cdc": "string",  "motivo": "string",  "protocoloAutorizacion": "string",  "codigoRespuesta": "string",  "mensajeRespuesta": "string",  "fechaCreacion": "2019-08-24T14:15:22Z",  "fechaProcesamiento": "2019-08-24T14:15:22Z",  "numeroTimbrado": 0,  "establecimiento": "string",  "puntoExpedicion": "string",  "numeroInicio": "string",  "numeroFin": "string",  "tipoDocumento": 0,  "serieNumero": "string"}