Webservice 'CommSvcConnector' voor externe berichten

Je gebruikt webservices voor het transport van gegevens van een naar een Profit-database. Voor het inlezen van externe berichten en statusinformatie gebruik je de webservice 'CommSvcConnector.asmx'.

URL

https://12345.soap.afas.online/profitservices/AppConnectorCommSvc.asmx

Vervang 12345 door je eigen deelnemernummer.

Let op:

Je vindt alle URL's voor connectoren op de centrale pagina URL's van WebServices.

Methode GetMessageStatus

De Status van een bericht ophalen uit een omgeving op basis van een berichtcode ('messageId').

Velden:

• token: de token die je hebt aangemaakt in de app connector. Deze bevat de omgeving en de systeemgebruiker.
• messageId: code van het bericht dat je wilt ophalen. Dit is een interne code uit Profit.

Je kunt deze methode uitvoeren via een browser om deze te testen (als je de webservice aanroept via een 'localhost'). Vul de testwaarden in het formulier in en klik op 'Invoke'.

Methode GetUpdatesMessages

Codes van berichten ophalen die gewijzigd zijn na de laatste keer dat je de statussen van berichten ophaalde. Nadat je deze codes hebt opgehaald, kun je de status per bericht ophalen met de methode 'GetMessageStatus'.

Velden:

• token: de token die je hebt aangemaakt in de app connector. Deze bevat de omgeving en de systeemgebruiker.
• messageStatusFilter: Filter op statuscode. Dit veld is optioneel. Als je dit veld leeg laat, haal je alle gewijzigde berichten op. Als je het veld vult met een statuscode, haal je alleen gewijzigde berichten met de betreffende status op.

Je kunt deze methode uitvoeren via een browser om deze te testen (als je de webservice aanroept via een 'localhost'). Vul de testwaarden in het formulier in en klik op 'Invoke'.

Methode UpdateMesssage

Aangifteberichten inlezen in Profit. Na het inlezen moet je de berichten verwerken met de commandline-optie 'COMMCONNPROCES'.

Velden:

• token: de token die je hebt aangemaakt in de app connector. Deze bevat de omgeving en de systeemgebruiker.
• messageType:

  Het type aangifte. Gebruik één van deze waarden:

  • BTW
  • ICP
  • LH
  • KVK
• externalMessageId: Id dat je zelf mag bepalen.
• messageContent: Aangifte in XML-formaat of XBRL-formaat, gezipt ('deflate', als base64coded string).

  Gebruik de juiste versie van de 'Nederlandse taxonomie' (NT):

  • KVK: NT 7.0 / 8.0
  • Btw en icp: NT 8.0
  • LH: n.v.t. Alleen aangiften vanaf het loonjaar 2014 kunnen ingediend worden.
• messagePDF: PDF-bestand van de aangifte, gezipt ('deflate', als base64coded string).

De velden 'externalMessageId' en 'messagePDF' zijn optioneel, maar dit kun je niet afleiden uit de WSDL. De andere velden zijn verplicht.

Bij deze methode is geen formulier beschikbaar, je kunt deze methode niet testen door vanuit een browser de webservice aan te roepen.

Zie ook

• Connector aanroepen via Profit WebServices