SOAP

El WSDL

Empieza por acá: https://api.datario.cl/soap/v1?wsdl. SOAP 1.1 document/literal (WS-I Basic Profile) — lo que importan sin drama SoapUI, el SoapClient de PHP, WCF y JAX-WS: apunta tu herramienta al WSDL y las operaciones se generan solas.

¿Prefieres Postman? La colección descargable trae los sobres listos.

Autenticación

La key va en el header HTTP Authorization: Bearer, igual que en los demás mecanismos — el sobre no lleva credencial adentro. Un mecanismo distinto no es una credencial distinta: mismo header, misma key, mismos errores. El detalle está en Empezar.

Lo que descuenta

Cada operación descuenta lo mismo que su gemela REST — el precio es del dato, no del sobre—: el índice de abajo lo dice operación por operación. El sobre de respuesta trae su propio eco del consumo, y los headers X-Plan-* viajan en la respuesta HTTP. La tabla completa está en Empezar.

Productos por SOAP

Una página por producto, con la petición en cada lenguaje y la respuesta real de cada operación. Lo que descuenta cada una es lo mismo por REST, SOAP, GraphQL y MCP: pagas por el dato, no por el protocolo.

Faults

Todo desenlace no-feliz es un soap:Fault con HTTP 500, como manda SOAP 1.1. Adentro van el mismo código y el mismo texto del REST (error/detail) más estado_http, que dice qué habría respondido REST.

• 401 api_key_invalida — No mandaste el header, o no empieza con dtr_.
• 401 api_key_invalida — La key viajó bien pero ya no sirve: la revocaste o la rotaste.
• 422 rut_invalido — El dígito verificador no corresponde al cuerpo. No se cobra: no hubo consulta.
• 422 rut_invalido — No tiene forma de RUT: cuerpo fuera de 7-8 dígitos, o los ocho caracteres sin guion, que son ambiguos.
• 503 padron_no_disponible — Nunca pasa en régimen. Solo si la primera carga del padrón no ha corrido.
• 429 limite_de_velocidad — Fuiste más rápido que las consultas por minuto de tu plan. Retry-After dice cuánto esperar.
• 402 sin_saldo — Se agotaron las consultas del plan y no hay saldo de recargas. Las consultas se detienen hasta que renueven.
• 402 saldo_protegido — Se agotaron las consultas del plan, hay saldo de recargas, y el interruptor «usar mi saldo automáticamente» está apagado. Nada se cobra.
• 404 rut_no_registrado — El RUT es válido pero el SII no lo tiene. SÍ descuenta lo que cuesta la operación pedida: «no está» también es información. Descuenta una consulta.
• 400 soap_invalido — El cuerpo no parsea como XML. No descuenta.
• 400 soap_invalido — XML válido pero sin el Envelope del namespace SOAP 1.1.
• 400 soap_invalido — Envelope sin Body: no hay operación que despachar.
• 400 soap_invalido — Body presente pero sin wrapper.
• 400 soap_invalido — El wrapper no es una operación conocida ({op} es lo que llegó).
• 413 envelope_demasiado_grande — El transporte corta antes de parsear. No descuenta.

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
 <soap:Body>
  <soap:Fault>
   <faultcode>soap:Client</faultcode>
   <faultstring>El RUT no es válido: revisa el dígito verificador.</faultstring>
   <detail>
    <falla xmlns="https://api.datario.cl/soap/v1">
     <error>rut_invalido</error>
     <detail>El RUT no es válido: revisa el dígito verificador.</detail>
     <estado_http>422</estado_http>
    </falla>
   </detail>
  </soap:Fault>
 </soap:Body>
</soap:Envelope>