Gusex.Soap (gusex v1.3.0)

Copy Markdown View Source

SOAP support module for Gusex.

Summary

Functions

Generate SOAP envelope for retrieving a full report for a specific entity in BIR service. Accepts a REGON number, report name, and endpoint URL. Returns a string containing the SOAP envelope XML.

Generate SOAP envelope for retrieving an aggregate report from BIR service. Accepts a report date, report name, and endpoint URL. Returns a string containing the SOAP envelope XML.

Generate SOAP envelope for searching entities in BIR service. Accepts a %ParametryWyszukiwania{} struct and an endpoint URL, which can be either the test or production URL. Returns a string containing the SOAP envelope XML.

Generate SOAP envelope for retrieving a service parameter value from BIR service. Accepts a parameter name and endpoint URL. Returns a string containing the SOAP envelope XML.

Generate SOAP envelope for logging out from BIR service. Accepts a session ID and endpoint URL. Returns a string containing the SOAP envelope XML.

Generate SOAP envelope for logging in to BIR service. Accepts a user key and an optional environment parameter (default is :test). Returns a string containing the SOAP envelope XML.

Functions

dane_pobierz_pelny_raport(regon, report_name, endpoint_url)

Generate SOAP envelope for retrieving a full report for a specific entity in BIR service. Accepts a REGON number, report name, and endpoint URL. Returns a string containing the SOAP envelope XML.

Parameters

  • regon: The REGON number of the entity (9 or 14 digits).
  • report_name: The name of the report to retrieve (e.g., "BIR12OsPrawna", "BIR12OsFizycznaDaneOgolne").
  • endpoint_url: The endpoint URL for the BIR service, which can be either the test or production URL.

Returns

  • A string containing the SOAP envelope XML for the full report request.

dane_pobierz_raport_zbiorczy(report_date, report_name, endpoint_url)

Generate SOAP envelope for retrieving an aggregate report from BIR service. Accepts a report date, report name, and endpoint URL. Returns a string containing the SOAP envelope XML.

Parameters

  • report_date: The date for the report in the only correct format: "YYYY-MM-DD".
  • report_name: The name of the aggregate report to retrieve.
  • endpoint_url: The endpoint URL for the BIR service, which can be either the test or production URL.

Returns

  • A string containing the SOAP envelope XML for the aggregate report request.

dane_szukaj_podmioty(search_params, endpoint_url)

Generate SOAP envelope for searching entities in BIR service. Accepts a %ParametryWyszukiwania{} struct and an endpoint URL, which can be either the test or production URL. Returns a string containing the SOAP envelope XML.

Parameters

  • search_params: A %Gusex.Types.ParametryWyszukiwania{} struct containing search parameters.
  • endpoint_url: The endpoint URL for the BIR service, which can be either the test or production URL.

Returns

  • A string containing the SOAP envelope XML for the entity search request.

get_value(parameter_name, endpoint_url)

Generate SOAP envelope for retrieving a service parameter value from BIR service. Accepts a parameter name and endpoint URL. Returns a string containing the SOAP envelope XML.

Parameters

  • parameter_name: The name of the parameter to retrieve (e.g., "StatusSesji", "KomunikatKod").
  • endpoint_url: The endpoint URL for the BIR service, which can be either the test or production URL.

Returns

  • A string containing the SOAP envelope XML for the parameter value request.

wyloguj(session_id, endpoint_url)

Generate SOAP envelope for logging out from BIR service. Accepts a session ID and endpoint URL. Returns a string containing the SOAP envelope XML.

Parameters

  • session_id: The session identifier to terminate.
  • endpoint_url: The endpoint URL for the BIR service, which can be either the test or production URL.

Returns

  • A string containing the SOAP envelope XML for the logout request.

zaloguj(user_key, endpoint_url)

Generate SOAP envelope for logging in to BIR service. Accepts a user key and an optional environment parameter (default is :test). Returns a string containing the SOAP envelope XML.

Parameters

  • user_key: The user key for authentication.
  • endpoint_url: The endpoint URL for the BIR service, which can be either the test or production URL.

Returns

  • A string containing the SOAP envelope XML for the login request.