DGII receiver (electronic invoices sent to you)
Receive on your Mac the electronic invoices (e-CF) other businesses send you and answer their commercial approvals, with receipts signed by your certificate, as DGII requires.
If your business is an electronic issuer in the Dominican Republic, DGII asks you to keep a few internet addresses always available, where other businesses and DGII itself send your electronic invoices (e-CF) and the commercial approvals of the ones you issued. The DGII receiver in Billing gives you those addresses and answers for you from your Mac.
What you need
- Billing set up with the Dominican Republic as the country and your business's RNC. Every receipt carries your RNC.
- Your business's digital certificate (the one for signing electronic invoices) kept on this Mac. It stays in the Mac's keychain and never leaves it: every receipt is signed with it, and it links your receiver to this Mac.
- Your business in DGII's electronic invoicing process (certification) or already authorized (production).
Turning it on
- Open Billing › Settings.
- Under DGII receiver, choose the DGII environment: «Certification (tests)» while you go through certification, «Production» once DGII has authorized you.
- Tick «Receive electronic invoices on this Mac».
The state turns to «On, receiving» when your Mac is connected.
Registering the addresses with DGII
Four addresses are listed below, each with its copy button. They are your business's alone and do not change. Copy each one into its box in DGII's portal, in the electronic invoicing registration:
- «Authentication (seed)» and «Authentication (signed seed)»: DGII and other businesses ask for a seed, sign it with their certificate and get a pass for one hour.
- «Reception»: the electronic invoices sent to you arrive here.
- «Commercial approval»: the approvals (or rejections) your customers give to the invoices you issued arrive here.
The addresses work in upper or lower case, as DGII requires.
Your Mac and the certificate's owner
Your addresses belong to your business, not to a Mac: they go with your books' backup and never change. What belongs to each Mac is its receiver key: it is made in that Mac's keychain, cannot be taken out of it and is in no copy of your books.
The first time your Mac connects, your addresses are linked to this Mac and to your certificate's owner, signed with that certificate. The page shows it under «Certificate owner»:
- «(the business's RNC)» when the certificate is in your business's name.
- «certificate in the representative's name» when the certificate carries the cédula or passport of the person who represents your business. DGII issues some certificates that way: the owner is that person, not the RNC.
A new Mac, or your books restored from a backup
Turn the receiver on on the new Mac. That Mac makes its own key and, with your certificate's signature (the same owner), your addresses move to it. The addresses you registered with DGII keep working; you change nothing there.
- If your phone is linked with Nobreiniers Chat, you get a notice each time the receiver moves to another Mac. If it was not you, check it now.
- The previous Mac shows «Moved to another Mac» and stops receiving. It does not start again by itself: only when you press «Receive on this Mac» on it (and then the other one stops).
- A Mac with a certificate of another owner cannot take your addresses.
A new representative
If the certificate saved on this Mac belongs to another owner (for example, your business has a new representative with their own certificate), the page tells you and offers «Change the certificate owner». The change happens only when you confirm it, never by itself; it is noted in the list of calls and your phones get the notice.
What happens to each invoice sent to you
DGII says the reception service answers with «Un xml de acuse de recibo firmado digitalmente» (a digitally signed acknowledgement of receipt). Your Mac checks each invoice and answers at once with a receipt signed with your certificate:
- Received (Estado 0): the invoice is for your RNC, of a type a buyer receives (31, 33, 34 or 44), and the sender's signature is valid.
- Not received (Estado 1), with the reason DGII lists:
- «4: RNC Comprador no corresponde»: the invoice is for another RNC.
- «1: Error de especificación»: the invoice does not follow the format, or is of a type not sent to a buyer.
- «2: Error de Firma Digital»: the signature is not valid, or the sender's certificate has expired or is not from an approved provider.
- «3: Envío duplicado»: you had already received that invoice (the same e-NCF from the same business) and your receipt reached the sender.
An invoice not received does not use up its number: the sender can fix it and send it again. And if your receipt did not reach the sender (the connection dropped), the invoice does not count as received either, so the next delivery is received normally.
Each invoice that arrives is kept in your books exactly as it came, with its receipt and the time, and none of it can be changed or deleted afterwards. You see it in the «Received» list.
Commercial approvals
When a customer approves or rejects an invoice you issued, their system sends it to «Commercial approval». DGII names two answers: «Satisfactorio: HTTP 200» and «Insatisfactorio: HTTP 400». Your Mac answers yes only when the approval matches an invoice you really issued and DGII accepted: the same issuer RNC (yours), the same e-NCF, the same date, the same total and the same customer RNC. If anything differs, it answers no.
When your Mac is not available
The receipt can only be signed on your Mac, with your certificate. If your Mac is off, asleep, closed or offline, the sender is told «try again later» (HTTP 503, with the recommended wait). A receipt is never made up. DGII gives no other answer for this case: it says «La disponibilidad de este servicio es de carácter obligatorio» (the service must always be available) and the receipt is always signed by the receiver.
So:
- Keep the Mac awake: while the receiver is on and the Mac is on the charger, the app does not let it go to sleep by itself (the screen may still turn off). You can turn this off.
- On battery the app does not keep it awake, so the battery is not drained; the page tells you.
- With the lid closed and no external screen, the Mac sleeps even on the charger.
- Each call that could not be answered is noted (only the time and the kind, never the content) and shows under «While your Mac was not available» when the Mac is back.
- If your phone is linked with Nobreiniers Chat, you get a notice: «Someone sent you an electronic invoice and your Mac was not available», at most one an hour.
Turning it off
Untick «Receive electronic invoices on this Mac». From then on senders are told «try again later» and the call is noted. Your addresses do not change: when you turn it on again they are the same.
