Mc2it.Agicap

0.5.0

Sources/Payments/Sync-Beneficiary.ps1

using namespace Mc2it.Agicap
using namespace Mc2it.Agicap.Payments
using namespace System.Net.Http

<#
.SYNOPSIS
    Starts a bulk synchronization of beneficiaries from the ERP software.
.OUTPUTS
    The identifier of the newly started synchronization.
#>
function Sync-Beneficiary {
    [CmdletBinding()]
    [OutputType([guid])]
    param (
        # The API client.
        [Parameter(Mandatory, Position = 1)]
        [Client] $Client,

        # The entity identifier.
        [Parameter(Mandatory, Position = 2)]
        [int] $EntityId,

        # The beneficiaries to synchronize.
        [Parameter(Mandatory, Position = 3)]
        [SynchronizedBeneficiary[]] $Beneficiaries,

        # Value indicating whether to wait until the synchronization is complete.
        [switch] $Wait
    )

    begin {
        $api = $Client.Payments.Beneficiaries($EntityId).Synchronization
    }

    process {
        try {
            $syncId = $api.Create($Beneficiaries)

            if ($Wait) {
                do { Start-Sleep 5; $synchronization = Get-BeneficiarySynchronization $Client $EntityId $syncId }
                while ($synchronization.Status -eq [BeneficiarySynchronizationStatus]::Running)
            }

            $syncId
        }
        catch [HttpRequestException] {
            Write-Error $_
        }
    }
}