Gebruik van het Magento 2 SnelStart CLI-commando voor debugging en validatie

Gebruik van het Magento 2 SnelStart CLI-commando voor Debugging en Validatie

Het opzetten van de SnelStart-boekhoudmodule in Magento 2 kan complex zijn, vooral bij het werken met One-Stop-Shopping, verschillende grootboekrekeningen en btw-regels. Synchronisatie tussen Magento en SnelStart kan problemen opleveren door API-beperkingen, onjuiste configuraties of ontbrekende gegevens.

Een nuttige debug-methode is om handmatig een boeking (transactie) aan te maken in SnelStart en vervolgens het CLI-commando te gebruiken om op te halen en te controleren hoe deze verwerkt is door de SnelStart API.

Waarom dit commando gebruiken?

Het accounting:check:snelstart commando helpt handelaren en ontwikkelaars om:

• Een boeking uit SnelStart op te halen en te inspecteren.
• Te verifiëren dat de juiste grootboekrekening is toegewezen.
• Te controleren of details zoals factuurnummer en bedragen correct zijn.
• Synchronisatieproblemen tussen Magento en SnelStart op te sporen.

Door dit commando te gebruiken, kun je verwachte versus werkelijke gegevens vergelijken, wat snelle foutopsporing en aanpassingen mogelijk maakt.

Hoe gebruik je het CLI-commando

1. Het Boeking-ID ophalen

Elke boeking in SnelStart heeft een unieke UUID die beschikbaar is via de API. Als je deze ID niet hebt,
gebruik dan de parameters --top en --skip om door transacties te bladeren.

Voorbeeld: De laatste boekingen ophalen

bin/magento accounting:check:snelstart --top=5

Dit haalt de 5 meest recente transacties op, inclusief hun UUID’s. Gebruik deze ID met de parameter --id om alle details te verkrijgen.

Voorbeeld: Volgende set boekingen ophalen

bin/magento accounting:check:snelstart --top=5 --skip=5

Gebruik --skip om de resultaten te verschuiven en het volgende setje op te halen.

Waar vind je de Boeking UUID

De boeking UUID verschijnt in het veld verkoopBoeking:

"verkoopBoeking": {
    "id": "eb44fcaa-e160-4be7-aa92-7d6e298b5b30",
    "uri": "/verkoopboekingen/eb44fcaa-e160-4be7-aa92-7d6e298b5b30"
}

Details van een specifieke boeking ophalen

bin/magento accounting:check:snelstart --id=eb44fcaa-e160-4be7-aa92-7d6e298b5b30

Voorbeeldoutput

{
    "factuurdatum": "2022-07-28T00:00:00",
    "factuurnummer": "C000000061",
    "boekingsregels": [
        {
            "omschrijving": "Rival Field Messenger",
            "grootboek": {
                "id": "4cbe5132-377f-43a5-86da-6289e75ae93a",
                "uri": "/grootboeken/4cbe5132-377f-43a5-86da-6289e75ae93a",
                "name": "[8000] - Omzet hoog (productiegoederen)"
            },
            "bedrag": -47.9,
            "btwSoort": "Hoog"
        },
        {
            "omschrijving": "Mollie Payment Fee",
            "grootboek": {
                "id": "217b3143-603e-4883-bcb2-179308ef7d4a",
                "uri": "/grootboeken/217b3143-603e-4883-bcb2-179308ef7d4a",
                "name": "[8040] - Omzet nultarief (productiegoederen)"
            },
            "bedrag": -0.99,
            "btwSoort": "Geen"
        }
    ]
}

Deze output bevestigt dat de transactie succesvol is toegevoegd en toont welke grootboekrekening is toegewezen. Gebruik deze resultaten om de juiste grootboekkoppelingen in Magento te configureren.

Het juiste Boeking ID ophalen

Volg deze stappen:

1. Voer bin/magento accounting:check:snelstart --top=5 uit om recente transacties op te halen.
2. Zoek het veld verkoopBoeking in de response.
3. Kopieer de id en gebruik deze met --id.

Tot slot

Het accounting:check:snelstart CLI-commando is een krachtig hulpmiddel voor het valideren van SnelStart-transacties, het controleren van grootboekkoppelingen en het oplossen van synchronisatieproblemen.

Door handmatig een transactie in SnelStart aan te maken en deze via dit commando op te halen, kun je snel configuratiefouten diagnosticeren en oplossen om zo correcte financiële gegevens in Magento te waarborgen.