Tipos de Cambio de Referencia

Cuando compra mercadería en dólares, factura a un cliente del extranjero o cobra en otra moneda, Zauru necesita el tipo de cambio correcto para convertir cada cifra. En esta pantalla puede establecer todos los tipos de cambio que su operación requiera y registrar de qué fuente obtuvo cada uno. La forma de hacerlo es la siguiente:

1. Ir a “Configuraciones”.
2. Seleccionar “Tipos de Cambio”.
3. Seleccionar “Nuevo Tipo de Cambio”.

Le aparecerán las opciones para crear el tipo de cambio, las opciones son las siguientes:

1. Fecha del tipo de cambio.
2. En esta opción deberá colocar del lado izquierdo la moneda local = Tipo de cambio de la moneda extranjera.
3. Aquí podrá colocar de que fuente se obtuvo el tipo de cambio.
4. Para guardar los cambios presione “Crear tipo de cambio”.

Le deberá aparecer un mensaje de éxito en la pantalla notificándole que el tipo de cambio fue creado exitosamente. Cada vez que se factura o se cobre en esta moneda, se utilizara el tipo de cambio más reciente para calcular la conversión de la moneda.

API (llamadas desde sistemas externos)

Listado de los tipos de cambio activos

curl -v \
  -H "Accept: application/json" \
  -H "Content-type: application/json" \
  -H "X-User-Email: prueba@zauru.com" \
  -H "X-User-Token: XSDFKK09238487DLFS" \
  https://app.zauru.com/settings/exchange_rates.json

Y esto me va a devolver un JSON con las siguientes características:

[
    {
        "created_at": "2020-08-21T10:00:48Z",
        "currency_exchange_id": 1,
        "currency_id": 2,
        "date": "2020-08-21",
        "entity_id": 2,
        "exchange": 7.70132,
        "id": 3,
        "source": "Banguat SOAP",
        "updated_at": "2020-08-21T10:00:48Z",
        "user_id": 1,
        "currency": {
            "code": "USD",
            "country": "US",
            "created_at": "2013-02-11T06:39:45Z",
            "id": 2,
            "name": "Dollar",
            "plural_name": "Dollars",
            "prefix": "$",
            "updated_at": "2020-05-30T01:27:51Z"
        },
        "currency_exchange": {
            "code": "GTQ",
            "country": "GT",
            "created_at": "2013-02-11T06:39:45Z",
            "id": 1,
            "name": "Quetzal",
            "plural_name": "Quetzales",
            "prefix": "Q",
            "updated_at": "2020-05-30T01:27:40Z"
        }
    }
]

Crear tipo de cambio

curl -v \
  -H "Accept: application/json" \
  -H "Content-type: application/json" \
  -H "X-User-Email: prueba@zauru.com" \
  -H "X-User-Token: XSDFKK09238487DLFS" \
  -X POST \
  -d '{
    "exchange_rate": {
      "date": "2024-05-01",
      "currency_id": "2",
      "currency_exchange_id": "1",
      "exchange": "7.80",
      "source": "Banco Central"
    }
  }' \
  https://app.zauru.com/settings/exchange_rates.json

Esto devolverá un JSON similar a este:

{
  "id": "1",
  "date": "2011-09-26",
  "user_id": "2",
  "entity_id": "2",
  "currency_id": "2",
  "currency_exchange_id": "1",
  "exchange": "7.91",
  "source": "seeds.rb",
  "created_at": "2013-01-08 16:54:55.991648",
  "updated_at": "2013-01-08 16:54:55.991648"
}

Exportar Tipos de Cambio

Zauru le permite exportar su historial de tipos de cambio en formato CSV o XLS. Para exportar:

1. Ir a "Configuraciones".
2. Seleccionar "Tipos de Cambio".
3. Seleccionar el formato de exportación deseado (CSV o XLS).

Los datos exportados incluyen: fecha, moneda de origen, tipo de cambio, moneda de destino, fuente, usuario que creó y fecha de creación.

Con su historial de tipos de cambio al día, las conversiones en facturas y cobros se harán siempre con la referencia correcta. Recuerde actualizar el tipo de cambio cada vez que la moneda se mueva; también puede exportar el historial en CSV o XLS cuando necesite revisarlo fuera de Zauru.

Exportar vía API

curl -v \
  -H "Accept: application/json" \
  -H "Content-type: application/json" \
  -H "X-User-Email: prueba@zauru.com" \
  -H "X-User-Token: XSDFKK09238487DLFS" \
  https://app.zauru.com/settings/exchange_rates/export.csv

Obtener detalle de un tipo de cambio con historial

curl -v \
  -H "Accept: application/json" \
  -H "Content-type: application/json" \
  -H "X-User-Email: prueba@zauru.com" \
  -H "X-User-Token: XSDFKK09238487DLFS" \
  https://app.zauru.com/settings/exchange_rates/1.json

Esto devolverá un JSON similar a este:

{
  "id": 1,
  "date": "2011-09-26",
  "user_id": 1,
  "entity_id": 1,
  "currency_id": 1,
  "currency_exchange_id": 2,
  "exchange": 7.91,
  "source": "seeds.rb",
  "created_at": "2013-01-08T16:54:55.991Z",
  "updated_at": "2013-01-08T16:54:55.991Z"
}