Nominar el receptor de una factura innominada
Identifica al receptor de una factura innominada aprobada mediante un evento de nominación ante SIFEN. 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.
Authorization
apiKey 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.
En PROD, la clave requiere un plan que incluya la API de integración; si no, toda ruta
responde 403 plan-operation-not-allowed.
In: header
Path Parameters
Header Parameters
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"}