VendemasIntercambios DTE
Registrar aceptacion/reclamo de DTE en el SII
Registrar aceptacion/reclamo de DTEs recibidos ante el SII.
POST
/api/v1/vendemas/dte/intercambios/respuesta_siiv1 · ESTABLEPOST /api/v1/vendemas/dte/intercambios/respuesta_sii
Registrar aceptacion/reclamo de DTEs recibidos ante el SII.
Registra respuestas de intercambio para multiples DTEs (aceptar, reclamar contenido, otorgar recibo de mercaderias, etc.). Delega al WebService SOAP SiiReclamoDteService.
Autenticacion requerida: API token en header X-API-Token con scope vendemas:write
- certificado digital en
auth.cert(PFX o PEM).
Quota: Consume 1 consulta | Peso: 5x (operacion critica)
Parametros de consulta
| Parametro | Tipo | Default | Descripcion |
|---|---|---|---|
ambiente | string | 0 | 0 produccion, 1 certificacion |
Body (JSON)
| Campo | Tipo | Requerido | Descripcion |
|---|---|---|---|
auth.cert.* | string | Si | Certificado PFX o PEM |
documentos[] | array | Si | Lista de documentos a registrar |
Cada documento: RUTEmisor, TipoDTE, Folio, EstadoRecepDTE.
Acciones validas (EstadoRecepDTE)
| Codigo | Descripcion |
|---|---|
ACD | Acepta contenido del documento |
RCD | Reclamo contenido del documento |
ERM | Otorga recibo de mercaderias o servicios |
RFP | Reclamo falta parcial de mercaderia |
RFT | Reclamo falta total de mercaderia |
Respuesta exitosa (200)
Diccionario con resultados por documento indexados por T{TipoDTE}F{Folio}.
Errores especificos
| Codigo | error_code | Causa | Resolucion |
|---|---|---|---|
| 400 | VALIDATION_ERROR | documentos vacio o accion invalida | Revisar body |
| 400 | AUTH_ERROR | Certificado invalido | Renovar certificado |
| 401 | HTTP_401 | API token ausente o invalido | Enviar X-API-Token valido |
| 403 | INSUFFICIENT_SCOPE | Token sin scope vendemas:write | Generar token con scope |
| 429 | SII_RATE_LIMIT / QUOTA_EXCEEDED | Rate limit | Respetar Retry-After |
| 502 | VENDEMAS_ERROR | SII rechazo la operacion | Revisar details |
Parámetros
Header / Body
Tipo
Descripción
Requerido
ambiente
string · query
`0` ambiente de produccion. `1` ambiente de certificacion
No
Respuestas
200Respuesta de intercambio registrada
400Datos invalidos o credenciales SII incorrectas
401API token ausente o invalido
403Sin scope `vendemas:write` o cuenta bloqueada
422Body con formato invalido
429Limite de tasa excedido
502Error en servicio SII upstream
503SII en mantenimiento
Forma de la respuesta
Código 200. Estructura del JSON devuelto.