Web Service OSE

El Operador de Servicios Electrónicos (OSE) proporciona al emisor un Servicio Web Seguro (WSS) para el envío y consulta de comprobantes y documentos electrónicos. Toda comunicación se realiza mediante mensajes SOAP sobre HTTPS, con autenticación por token en el header de cada solicitud.

Protocolo

SOAP 1.1

Transporte

HTTPS + SSL

Autenticación

WS-Security UsernameToken — formato {RUC}{usuario}

Formato de envío

ZIP codificado en Base64

Formato de respuesta

CDR (ApplicationResponse UBL 2.1) codificado en Base64

Ambientes

PRODUCCIÓNhttps://ose.gosocket.net/ol-ti-itcpe/billService

SANDBOXhttps://ose-sbx.gosocket.net/ol-ti-itcpe/billService

Respuestas HTTP

200OKSolicitud procesada correctamente

401UnauthorizedAcceso no autorizado

406Not AcceptableDocumento rechazado

503Service UnavailableServicio inhabilitado

Métodos disponibles

sendBillSíncronoEnvía un comprobante electrónico (factura, boleta, nota de crédito/débito, retención, percepción o DAE) y retorna el CDR de forma inmediata.sendSummaryAsíncronoEnvía resúmenes diarios de boletas, comunicaciones de baja o reversiones. Retorna un ticket para consultar el resultado con getStatus.getStatusSíncronoConsulta el estado de un proceso asíncrono iniciado con sendSummary usando el ticket retornado. Retorna el CDR cuando el procesamiento ha concluido.getStatusCdrSíncronoObtiene el CDR de un comprobante enviado con sendBill, identificándolo por RUC, tipo, serie y número — sin necesidad de un ticket.