Excel a KOSMOS con un clic: envía tus pólizas desde tu hoja de cálculo (sin ser programador)
Si tu contabilidad vive en Excel, no necesitas un sistema nuevo ni un programador. Con una macro, un pequeño programa guardado dentro del propio libro, puedes revisar y enviar las pólizas del mes a KOSMOS Impuestos con un clic.
Antes de empezar
- Excel para Windows. La macro usa un componente que trae Windows; en Excel para Mac no funciona.
- Tu llave de la API (
kha_…, alcancesync), creada en el portal en Seguridad > Llaves de la API.
Paso 1. Prepara el libro
- Abre el Excel de prueba que te enviamos, o un libro tuyo con las hojas Config y Polizas.
- Ve a Archivo → Guardar como y elige Libro de Excel habilitado para macros (*.xlsm).
- Activa la pestaña Programador: Archivo → Opciones → Personalizar cinta de opciones → marca «Programador».
Paso 2. Guarda tu llave fuera del archivo
La llave nunca va dentro del Excel: si compartes el archivo, la compartirías también. Se guarda una sola vez en Windows:
- En el menú Inicio escribe variables de entorno y abre «Editar las variables de entorno de esta cuenta».
- En Variables de usuario pulsa Nueva. Nombre:
KOSMOS_API_KEY. Valor: tu llave. - Acepta y cierra y vuelve a abrir Excel.
Paso 3. Agrega la macro
- En la pestaña Programador pulsa Visual Basic.
- Archivo → Importar archivo… y elige
KOSMOS_Excel.bas, o pega el código de abajo en un módulo nuevo (Insertar → Módulo). - Cierra la ventana de Visual Basic. Listo: la macro ya vive en tu libro.
Paso 4. Llena las hojas
| Hoja | Qué va |
|---|---|
| Config | B1 = RFC, B2 = año, B3 = mes (1 a 12) |
| Polizas | Una fila por partida: número de póliza, fecha, tipo (I, E o D), descripción, cuenta, cargo y abono. Las partidas de una póliza van juntas con el mismo número. |
Cada póliza debe cuadrar (cargos = abonos), tener al menos dos partidas y una descripción de 5 caracteres o más.
Paso 5. Revisa y envía
- Programador → Macros → ValidarPolizasKOSMOS → Ejecutar. El portal revisa todo sin guardar nada y te muestra el resultado.
- Si hay errores, corrige las filas que te indica y vuelve a validar.
- Cuando salga bien, ejecuta EnviarPolizasKOSMOS. Si reenvías el mismo mes, se reemplaza: no se duplica.
Tip: en Programador → Insertar → Botón puedes dibujar dos botones, «Validar» y «Enviar», y asignarles cada macro.
La macro completa
Es corta y está comentada. Si tienes alguien de sistemas cerca, puede revisarla en cinco minutos.
KOSMOS_Excel.bas (VBA)
Attribute VB_Name = "KOSMOS"
' KOSMOS Impuestos: enviar las pólizas de esta hoja de Excel a la API v1.
' Excel para Windows (usa MSXML2.ServerXMLHTTP, incluido en Windows).
'
' Hojas que espera el libro:
' Config B1 = RFC, B2 = año, B3 = mes (1 a 12)
' Polizas fila 1 = títulos; desde la fila 2:
' A número | B fecha | C tipo (I, E o D) | D descripción | E cuenta | F cargo | G abono
' Una fila por partida; las partidas de una misma póliza van juntas y con el mismo número.
'
' La llave NO se escribe en el libro: se lee de la variable de entorno KOSMOS_API_KEY.
Option Explicit
Private Const URL_BASE As String = "https://portal.kosmostek.net/api/v1"
' Revisa el mes con el portal SIN guardar nada. Úsala siempre primero.
Public Sub ValidarPolizasKOSMOS()
Llamar "/sync/validate"
End Sub
' Envía el mes al portal (reemplaza lo que la API mandó antes para ese mes).
Public Sub EnviarPolizasKOSMOS()
If MsgBox("¿Enviar las pólizas de " & Hoja("Config").Range("B3").Value & "/" & Hoja("Config").Range("B2").Value & _
" a KOSMOS? Se reemplaza lo que la API mandó antes para ese mes.", vbYesNo + vbQuestion) = vbYes Then
Llamar "/sync/batches"
End If
End Sub
Private Sub Llamar(ruta As String)
Dim llave As String
llave = Environ("KOSMOS_API_KEY")
If llave = "" Then
MsgBox "Falta la variable de entorno KOSMOS_API_KEY. Ver el paso 2 del instructivo.", vbExclamation
Exit Sub
End If
Dim cuerpo As String
cuerpo = ArmarLote()
If cuerpo = "" Then Exit Sub
Dim http As Object
Set http = CreateObject("MSXML2.ServerXMLHTTP.6.0")
http.Open "POST", URL_BASE & ruta, False
http.setRequestHeader "Authorization", "Bearer " & llave
http.setRequestHeader "Content-Type", "application/json; charset=utf-8"
If ruta = "/sync/batches" Then
http.setRequestHeader "Idempotency-Key", "excel-" & Hoja("Config").Range("B1").Value & "-" & Format(Now, "yyyymmddhhnnss")
End If
http.send Utf8(cuerpo)
MsgBox "KOSMOS respondió " & http.Status & vbCrLf & vbCrLf & Left(http.responseText, 900), _
IIf(http.Status < 300, vbInformation, vbExclamation)
End Sub
' Arma el lote JSON a partir de la hoja Polizas.
Private Function ArmarLote() As String
Dim cfg As Worksheet, ws As Worksheet
Set cfg = Hoja("Config")
Set ws = Hoja("Polizas")
Dim json As String, fila As Long, ultima As Long, numero As Variant, abierta As Boolean
json = "{""rfc"":""" & Texto(cfg.Range("B1").Value) & """,""kind"":""entries"",""mode"":""replace""," & _
"""year"":" & CLng(cfg.Range("B2").Value) & ",""month"":" & CLng(cfg.Range("B3").Value) & ",""items"":["
ultima = ws.Cells(ws.Rows.Count, "A").End(xlUp).Row
If ultima < 2 Then
MsgBox "La hoja Polizas no tiene renglones.", vbExclamation
Exit Function
End If
numero = Empty
For fila = 2 To ultima
If ws.Cells(fila, "A").Value <> numero Then
If abierta Then json = json & "]},"
numero = ws.Cells(fila, "A").Value
json = json & "{""number"":" & CLng(numero) & _
",""date"":""" & Format(ws.Cells(fila, "B").Value, "yyyy-mm-dd") & """" & _
",""type"":""" & UCase(Texto(ws.Cells(fila, "C").Value)) & """" & _
",""description"":""" & Texto(ws.Cells(fila, "D").Value) & """,""lines"":["
abierta = True
Else
json = json & ","
End If
json = json & "{""account"":""" & Texto(ws.Cells(fila, "E").Value) & """"
If Val(ws.Cells(fila, "F").Value) <> 0 Then json = json & ",""debit"":" & Importe(ws.Cells(fila, "F").Value)
If Val(ws.Cells(fila, "G").Value) <> 0 Then json = json & ",""credit"":" & Importe(ws.Cells(fila, "G").Value)
json = json & "}"
Next fila
If abierta Then json = json & "]}"
ArmarLote = json & "]}"
End Function
' Importe con punto decimal y 2 decimales, sin importar la configuración regional de Windows.
Private Function Importe(v As Variant) As String
Importe = Replace(Format(CDbl(v), "0.00"), ",", ".")
End Function
' Texto seguro para JSON: escapa diagonales invertidas y comillas.
Private Function Texto(v As Variant) As String
Texto = Replace(Replace(Trim(CStr(v)), "\", "\\"), """", "\""")
End Function
' Convierte el texto a bytes UTF-8 (acentos y eñes llegan bien al portal).
Private Function Utf8(s As String) As Variant
Dim st As Object
Set st = CreateObject("ADODB.Stream")
st.Type = 2: st.Charset = "utf-8": st.Open
st.WriteText s
st.Position = 0: st.Type = 1: st.Position = 3 ' salta la marca BOM de 3 bytes
Utf8 = st.Read
st.Close
End Function
Private Function Hoja(nombre As String) As Worksheet
Set Hoja = ThisWorkbook.Worksheets(nombre)
End Function
¿Quieres el Excel de prueba o una demostración? silvano@kosmostek.net · +52 55 1397 5173.
¿Programas en otro lenguaje? Tenemos ejemplos en 21 lenguajes.
