Amili Perintä

• Only invoices with currency EUR are accepted.
• Valid XML file. Service does not support the following invoice XMLs: OIOXML, WoodX, BGC, Axflow, Facturae, PX, UBL, Facturae.
• Full receiver’s address information is given: If there is something missing from the receiver’s address details your invoice will not be successfully forwarded for the Amili Perintä service.
• Duplicate invoice numbers are not allowed in most cases. Ensure that each invoice number is unique, avoiding any reuse. However, there are few exceptions to this rule:
  • If a new invoice has a different invoice date than an existing assignment (open or closed), a new assignment with the same invoice number is created.
  • If a new invoice has the same invoice date as an existing closed assignment with no associated payments or credit notes (manually closed or canceled by the sender), a new assignment with the same invoice number is created.
  • If a new invoice has the same invoice date as an existing open assignment with no associated payments or credit notes, and the invoice connected to that assignment is in an error state, the existing assignment is closed, and a new assignment with the same invoice number is created.
• Sum of lines must equal the total sum of the invoice

comment - Add a comment or question. With this event you can add a comment or ask a question from Visma Amili related to the assignment in question. Amili will also use this event for sending comments or questions to your company.

NOTE! There is a new improved messaging functionality available now to handle the communication better. More information from the message functionality

Both company and Visma Amili can send this event.

paid - This event is used for notifying when assignment gets paid by the customer, for informing direct payment and for marking credit note as used.

• Notifying when assignment gets paid by the customer: Amili Oy will use this event to notify when the customer has paid the assignment either fully or partly. If the customer pays the whole sum Amili Oy marks the assignment as closed (close event is added). If the customer pays more than the invoice sum is the extra money is returned to the customer. So there is no way of paying more than one invoice at a time. Amili Oy won’t save the money to upcoming payments. In account statement (for example SEPA) all the payments done by Amili Oy have VISMA AMILI as a payer’s name abbreviation (name could be shorter or longer depending on bank). This information can be used to identify direct payments which will then have something else as payer’s name.
• Inform direct payments: With this event you can inform Amili Oy if the customer has made a direct payment to your company’s account. Amount paid can be either full or partial payment. Use a comment event if you want to give some additional information related to the payment. If assignment is fully paid Amili Oy will close the assignment afterwards (close event is added). It is really important to use this event to inform the direct payments in order for Amili Oy to know to update the sum that is still open or to close the assignment. We highly advice to automate this event from the ERP when direct payments happens.
• Mark credit note as used: When credit note is sent and connected to an assignment (credit_note event is used) credit note is also needed to be marked as used and that can be done using this event for the credit note and giving the paid sum as negative value. In this way Amili Oy will get the information to also mark the credit note as closed (close event is added). (When connecting a credit note to an assignment through our UI the credit note is marked automatically as used.)

Paid event will update the parameter “paid” in the assignment. the assignment “sum” does not get updated.

{
"type": "paid",
"data": {
    "sum_paid": 200.5,
    "booked_at": "2019-01-04",
    "archive_number": "12345"
}
}

Both company and Visma Amili can send this event.

close - This event is used by Amili Oy to mark the assignment as closed. Assignment gets closed when it is fully paid by the customer, marked as fully paid by the sender or if the sender has cancelled the assignment.

Only Visma Amili can send this event.

partially_closed - This event is used by Amili Oy to mark the assignment as partially closed. This is used when invoice sum is fully paid but customer did not pay reminder or collection charges. This means that from the mandator’s perspective the assignment is closed, but the customer still needs to pay more money to the Amili Oy. When assignment gets this event it’s status changes to ‘partially_closed’. When customer eventually pays the remining reminder or collection charges Amili Oy will add the close event and the assignment status changes to ‘Closed’

Only Visma Amili can send this event.

credit_note - You can connect a credit note to an assignment by giving the credit note number and credit sum with this event. This event is added for the assignment in question you want to connect the credit note to. Give the credit note sum as positive value in the request. If assignment is fully credited Amili Oy will close the assignment (close event is added). If the credit note is sent through Maventa you will also need to mark the credit note as used and connected by adding a paid event to the credit note assignment and give the paid sum as negative value. If the credit note is not sent through Maventa you should still use this event to inform Amili Oy for crediting the assignment so that they know to close the assignment, or if only part of the assignment is credited they will continue payment monitoring and possible debt collection process with a different sum.

If whole assignment is credited with the credit note:

• Assignment gets credit_note event with credit sum given as positive value
• Credit note gets paid event with paid sum as negative value

We highly advice to automate this event in the ERP side to always create credit_note event to an assignment when user creates credit notes in the ERP.

Only company can send this event.

cancel - You can cancel the whole receivable process for the assignment. Please note that this will close the assignment (close event is added) and the closing cannot be reversed or modified afterwards. Amili Oy will not monitor the assignment or take actions to collect the debt. Company is then responsible for monitoring the assignment. Do not use this for reporting a credit loss. Note! If reminder or collection actions have already been initiated, Amili Oy will charge the client a cancellation fee.

Only company can send this event.

freeze - You can request to suspend the debt collection process for the assignment in question until the specified date. Please note that once the suspension has been set, Amili Oy will not monitor the assignment or take actions to collect the debt. Company is then responsible for monitoring the assignment. The suspension can be requested until the legal collection has started or the enforcement authority has found the customer insolvant. The debt collection will automatically continue after the expiration date. You can request an update to the debt collection suspension expiration date by choosing a new date or you can end the suspension by setting today as the expiration date.

Set the parameter “frozen” to true

{
"type": "freeze",
"data": {
    "frozen": true,
    "end_date": "2019-01-04"
}
}

Only company can send this event.

freeze_confirmed - This event is added by Amili Oy as a confirmation when the Temporary suspension of debt collection has been set to an assignment.

{
"type": "freeze_confirmed",
"data": {
    "happened_at": "2019-01-04",
    "end_date": "2019-02-15"
}
}

Only Visma Amili can send this event.

unfreezed - The Temporary suspension of debt collection has been terminated and the debt collection of the assignment will continue.

{
"type": "unfreezed",
"data": {
    "happened_at": "2019-01-04"
}
}

Only Visma Amili can send this event.

interest_paid - With this event Visma Amili will inform if there was interest paid for an assignment and what was the interest amount. This event is usually received at the same time than the paid event. Interest will be paid daily as one payment that contains all the interests from the same day. Message in the account statement is “Korkotilitys PVM”.

Interest in this matter is the one defined by the sender for their invoices if the receiver does not pay on time. Note! Interest needs to be defined on the invoice XML. It is not enough to have it only on the invoice image.

Only Visma Amili can send this event.

cash_discount - With this event Amili Oy informs if the customer used cash discount on the payment and how much was the cash discount amount.

paid sum + cash_discount sum = assignment’s sum

This event is usually received at the same time than the paid event.

Only Visma Amili can send this event.

reminder_sent - This event is added by Amili Oy when a first payment reminder has been sent of an unpaid invoice. This event will set the “collection_status” of an assignment to reminder_sent if it is not already set.

Only Visma Amili can send this event.

second_reminder_sent - This event is added by Amili Oy when a second payment reminder has been sent of an unpaid invoice. This event will set the “collection_status” of an assignment to reminder_sent if it is not already set.

Only visma Amili can send this event.

collection_started - This event is added by Amili Oy when a first payment demand has been sent of an unpaid invoice. This event will set the “collection_status” of an assignment to debt_collection if it is not already set.

Only Visma Amili can send this event.

second_demand_sent - This event is added by Amili Oy when a second payment demand has been sent of an unpaid invoice. This event will set the “collection_status” of an assignment to debt_collection if it is not already set.

Only Visma Amili can send this event.

tratta_sent - A tratta has been sent of an unpaid invoice. This event will set the “collection_status” of an assignment to debt_collection if it is not already set.

Only Visma Amili can send this event.

legal_collection_started - A summons application has been sent and legal collection of the assignment has started. This event will set the “collection_status” of an assignment to legal_collection.

Only Visma Amili can send this event.

application_for_enforcement - An application for enforcement has been sent and the assignment has been transferred to the enforcement authority. This event will set the “collection_status” of an assignment to recovery_proceedings.

Only Visma Amili can send this event.

lack_of_means - The enforcement authority has found the debtor insolvent. This event will set the “collection_status” of an assignment to lack_of_means.

Only Visma Amili can send this event.

payment_plan - A payment plan has been agreed on the invoice. This event will set the “collection_status” of an assignment to payment_plan.

Only Visma Amili can send this event.

credit_loss_suggestion - A recommendation from Amili Oy to mark the assignment as credit loss. This event will set the “collection_status” of an assignment to debt_surveillance.

Only Visma Amili can send this event.

credit_loss - You can mark a credit loss on assignment in question. Reporting a credit loss is only done for the accounting purposes and has no impact on the payment control and monitoring. Amili Oy will continue the collection process. Amili Oy will suggest that the sender marks the assignment as credit loss if they know the customer won’t pay it. Note! After posting, the credit loss cannot be reversed or modified.

Only company can send this event.

Following events exists but are not applicable when using the Amili Perintä service. Useful when Reskontravahti Auto is in use.

delivery_status service_level_changed - This event is created by Amili Oy if the customer of the invoice (receiver) is either on the VIP or PREMIUM service level group. If the service level group is changed, there will be a new event added. This event will set the “service_level” of an assignment to default / vip / premium based on the choosen service level group. Service levels are working with the Amili Perintä service, but there is really no need to use them. due_date_changed - This is an event that will be received when due date change request is approved by Amili Oy. This will update the assignment’s due date. Note! This won’t update the original invoice in question. due_date_change_request - Request a due date change. If there is a need to update the due date of an assignment, you can request the change. Visma Financial Solution Oy will either accept or reject the request depending on the new due date and how far in the collection process the assignment already is. If the debt collection process has been started, due date change will be rejected. When a due date change request is accepted you will receive a confirmation event (due_date_changed event is added) about the acceptance and due date is updated accordingly for the assignment (parameter due_date gets a new value).