RedBox Docs

Sambil

How to connect RedBox to Sambil so every sale from your store in the mall is reported automatically, what data is sent and when.

If your store operates inside Sambil Santo Domingo, the mall asks you to report your sales. With this integration you don't have to do it by hand: RedBox sends every closed sale straight to Sambil's sales system, a few minutes after it closes.

Before you start

  • An active paid license. Integrations unlock with it.
  • The Administrar integraciones permission on your user.
  • Your store's credentials from Sambil: a client ID and a secret. Each store has its own; if you run several stores, Sambil gives you one pair per store.

The secret is shown only once

Sambil shows the full secret only when it is created. Keep it somewhere safe until you paste it into RedBox. If it is lost, Sambil has to generate a new one.

Setting it up

Save your credentials

Go to Integraciones → Sambil, paste the client ID and the secret, and press Guardar. The service URL is already filled in with Sambil's address; don't change it unless Sambil tells you to. If you change the URL, you will have to enter the secret again.

The Integraciones → Sambil page in the admin panel: service URL, client ID, secret, Mall ID and Local ID, the connection test with its three steps passed, and sales reporting still turned off.
Integraciones → Sambil, with the connection test passed

Test the connection

Press Probar conexión. RedBox checks three things, in order:

StepWhat it checks
ServicioThat Sambil's system is online
AutenticaciónThat your credentials are valid, and which mall and store they belong to
Envío de pruebaThat Sambil accepts submissions from your store

The test submission does not record any sale: it is sent empty and flagged as a test. Once it passes you will see the Mall ID and Local ID Sambil associates with your credentials. Confirm they match your store.

Turn on sales reporting

With the test passed, press Activar. From that moment on, every sale you close is reported to Sambil.

Reporting starts when you turn it on, not before

Sales closed before you turned the integration on are not sent. If Sambil needs earlier sales, write to us.

What is sent

For each closed sale, RedBox sends one line with these fields and nothing else:

FieldWhere it comes from
Document typeAlways factura
Document numberThe order number followed by an internal identifier, e.g. 000123-4589123
Sale dateThe sale's business day, the same one your sales-by-day report uses
Sale timeThe closing time, in your establishment's time zone
Gross totalWhat the customer was charged
Tax totalITBIS plus the legal service charge, when it applies
Net totalThe gross total minus taxes

No customer, product or payment data is sent. Voluntary tips are not part of any total: they belong to your staff, not to the store's sales.

Why does the document number have two parts?

If you have several terminals, two of them can use the same order number on the same day. Sambil identifies each sale by its number, so RedBox appends an internal identifier that never repeats. The first part is still the number on the receipt, so you can find the sale.

When it is sent

Sales go out on their own, a few minutes after closing. If a sale that was already sent changes later — say a discount or an amount is corrected — RedBox sends it again with the same document number, and Sambil updates the sale instead of duplicating it.

If Sambil is unavailable at that moment, nothing is lost: RedBox tries again on the next run, starting from the same sale.

Rejected sales

Sambil can reject a specific sale, for example because of a field it does not accept. When that happens, RedBox keeps sending the rest of your sales and puts the rejected one in the Ventas rechazadas list at the bottom of the Integraciones → Sambil page. The list only appears while there are rejected sales and shows, for each one:

  • The document, with a link to open the order.
  • The closing time and the total.
  • Sambil's message explaining the rejection.
  • The number of attempts so far.

A rejected sale is not sent again on its own until the order changes. If you fix the order, RedBox sends it again on the next run. You can also act from the list:

ActionWhat it does
ReintentarSends that sale to Sambil right now and shows you the answer. If Sambil accepts it, it leaves the list
Reintentar todasRetries the rejected sales, up to 50 at a time, oldest first. If more remain, press it again. If it takes too long it stops and tells you how many are left
DescartarRemoves the sale from the list. It will not be sent to Sambil unless the order changes later

Retrying is only available while sales reporting is on: if it was turned off, fix the cause, turn it back on and then retry.

Automatic pause

If Sambil keeps rejecting sales —3 sales in a row, 5 times in a row, without accepting any sale in between— it is a sign that Sambil is refusing everything your store sends, not just one sale. In that case RedBox turns off sales reporting so it stops trying. While it is off, your sales keep closing as usual and nothing is lost. When you turn it back on, RedBox continues from where it stopped, including the sales closed during the pause.

When this happens, the Integraciones → Sambil page shows a red box next to the Activar button with the message "Envío de ventas desactivado tras 5 intentos seguidos con ventas rechazadas por Sambil", and while the count is building you will see "Intentos seguidos con rechazos: N de 5". Check Sambil's message in the rejected sales list, fix the cause (sometimes only Sambil can) and press Activar.

Get notified when it turns off

To find out without opening the page, go to Integraciones → Notificaciones and create a notification for the event integrations.sambil.disabled (in the Integraciones section, with the SAMBIL tag; the email is titled "Sambil: envío de ventas desactivado"). You can receive it by email or by webhook.

Integration status

Below the reporting switch you will see:

FieldWhat it shows
Último intentoWhen RedBox last tried to send sales
Último envío exitosoWhen Sambil last confirmed a submission
Último errorThe latest problem, with Sambil's message and, if it rejected sales, their document numbers. Rejected sales also stay in the Rejected sales list

Troubleshooting

Need help?

Write to us if Sambil asks you about your submissions, or if anything on this page doesn't match what you see.

Sambil · RedBox Docs