OSE Web Service

The Electronic Services Operator (OSE) provides the issuer with a Secure Web Service (WSS) for sending and querying electronic receipts and documents. All communication is done through SOAP messages over HTTPS, with token authentication in the header of each request.

Protocol

SOAP 1.1

Transport

HTTPS + SSL

Authentication

WS-Security UsernameToken — format {RUC}{username}

Submission format

Base64-encoded ZIP

Response format

CDR (ApplicationResponse UBL 2.1) Base64-encoded

Environments

PRODUCTIONhttps://ose.gosocket.net/ol-ti-itcpe/billService

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

HTTP responses

200OKRequest processed correctly

401UnauthorizedUnauthorized access

406Not AcceptableDocument rejected

503Service UnavailableService disabled

Available methods

sendBillSynchronousSends an electronic receipt (invoice, sales ticket, credit/debit note, withholding, perception or DAE) and returns the CDR immediately.sendSummaryAsynchronousSends daily sales-ticket summaries, void communications or reversals. Returns a ticket to query the result with getStatus.getStatusSynchronousQueries the status of an asynchronous process started with sendSummary using the returned ticket. Returns the CDR once processing has finished.getStatusCdrSynchronousObtains the CDR of a receipt sent with sendBill, identifying it by RUC, type, series and number — without needing a ticket.