{"activeVersionTag":"latest","latestAvailableVersionTag":"latest","collection":{"info":{"_postman_id":"c6091835-8f4c-47ef-b86e-219174167738","name":"🔌 API Suasor Contable","description":"Documentación de la API contable de Summar para integrarse con Suasor.\n\nPermite enviar a la contabilidad de Suasor clientes, proveedores, bancos, facturas y asientos, y registrarlos. Con la contabilidad al día, el despacho presenta desde Suasor los impuestos, el SII y los libros.\n\nLa API Contable incluye EDS, la entrada para las facturas de autónomos en estimación directa simplificada. EDS tiene su propia colección: \"API Suasor EDS\".\n\nTodas las llamadas deben realizarse con el \"id\" de la empresa de sistema con la que se quiere integrar. Para obtener el \"id\" de la empresa de sistema consultar \"companies\".\n\nPara poder enviar y leer información relacionada con una empresa contable, primero hay que activarla. Para realizarlo, consultar \"enableAccountingAPIIntegrations\".\n\nLa autenticación es básica, con un usuario y su clave de acceso al servicio web. Al activar la API, Summar by Silae entrega un usuario de prueba. Los usuarios definitivos los crea el despacho en Suasor, uno por cada programa que se conecta, y se los entrega a quien gestiona ese programa.\n\n# **Por dónde empezar**\n\n1. \"companies\": el \"id\" de la empresa de sistema ({{systemCompanyId}}).\n    \n2. \"accountingCompanies\": el \"id\" de la empresa contable ({{accountingCompanyId}}).\n    \n3. \"enableAccountingAPIIntegrations\": activar la empresa contable, una vez.\n    \n4. Consultas de configuración: \"accounts\", \"vatSetups\", \"customerPostingGroups\", \"vendorPostingGroups\", \"generalJournalTemplates\", \"generalJournalBatches\", \"accountingDepartments\", \"paymentMethods\" y \"paymentTerms\".\n    \n5. \"accountingCustomers\" y \"accountingVendors\": dar de alta clientes y proveedores.\n    \n6. \"invoices\" y \"postInvoices\": enviar y registrar facturas.\n    \n7. \"transactions\" y \"postTransactions\": enviar y registrar asientos.\n    \n\nSi \"companies\" o \"accountingCompanies\" no devuelven nada, el usuario no tiene empresas asignadas en «Usuarios API Contable».\n\n# **Versiones**\n\n- v1.0: 01/09/2025 - Versión inicial\n    \n- v1.1: 11/2026 - Revisión de las descripciones\n    \n\n# **Pruebas de la API**\n\nPara probar las diferentes funciones, con el botón \"Run in Postman\" se pueden probar las funciones en la aplicación de Windows de Postman o directamente en un navegador, y allí se pueden informar las variables y ejecutar cada función para ver el resultado.\n\n# **⚙️ Variables de la API**\n\nAntes de ejecutar los endpoints, asegúrate de definir las siguientes variables a nivel de \"Environment\":\n\n- {{systemCompanyId}}: \"id\" de la empresa sistema de Suasor. Necesario para cualquier integración/consulta.\n    \n- {{baseUrl}}: URL base de la API (ej. \"[https://servidor:7048/instancia/api/summar](https://servidor:7048/instancia/api/summar)\"). El puerto habitual es el 7048 y lo confirma Summar by Silae en cada instalación.\n    \n- {{user}}: usuario de la API. Lo crea el despacho en Suasor. En las pruebas, el usuario de prueba que entrega Summar by Silae.\n    \n- {{password}}: clave de acceso al servicio web de ese usuario. No es la contraseña de un usuario normal de Suasor.\n    \n- {{accountingCompanyId}}: \"id\" de la empresa contable. Necesario para algunas consultas y para la creación de facturas y asientos.\n    \n- {{customerGLAccountId}}: \"id\" de la cuenta contable cliente para la contabilización de facturas y asientos.\n    \n- {{vendorGLAccountId}}: \"id\" de la cuenta contable proveedor para la contabilización de facturas y asientos.\n    \n- {{bankGLAccountId}}: \"id\" de la cuenta contable banco para la contabilización de pagos y cobros.\n    \n- {{accountingCustomerGroupId}}: \"id\" del grupo contable cliente para la contabilización de facturas y asientos.\n    \n- {{accountingVendorGroupId}}: \"id\" del grupo contable proveedor para la contabilización de facturas y asientos.\n    \n- {{accountingBankGroupId}}: \"id\" del grupo contable banco para la contabilización de facturas y asientos.\n    \n- {{accountingDepartmentId}}: \"id\" del departamento contable para la contabilización de facturas y asientos.\n    \n- {{journalTemplateId}}: \"id\" diario para el registro de facturas y asientos.\n    \n- {{journalBatchId}}: \"id\" sección diario para el registro de facturas y asientos.\n    \n\n# **💡 Consejos prácticos**\n\nA continuación se presentan recomendaciones útiles para optimizar tus consultas OData en la API Contable de Suasor.\n\n**Recomendaciones:**\n\n- Sincronización continua: envía los movimientos cada cierto tiempo, no solo al cierre del periodo.\n    \n\n**Ayudas:**\n\n- Utilizar los endpoints \"metadata\" para tener más información sobre los distintos endpoints que ofrece la API\n    \n- Documentación oficial de OData:\n    \n    - [https://www.odata.org/getting-started/basic-tutorial/](https://www.odata.org/getting-started/basic-tutorial/)\n        \n    - [Using filters with API/OData calls - Business Central | Microsoft Learn](https://learn.microsoft.com/es-es/dynamics365/business-central/dev-itpro/developer/devenv-connect-apps-filtering)","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","isPublicCollection":false,"owner":"54161999","team":15190839,"collectionId":"c6091835-8f4c-47ef-b86e-219174167738","publishedId":"2sBYHaMwMg","public":true,"publicUrl":"https://apisuasor-contable.summarbysilae.es","privateUrl":"https://go.postman.co/documentation/54161999-c6091835-8f4c-47ef-b86e-219174167738","customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"documentationLayout":"classic-double-column","customisation":{"metaTags":[{"name":"description","value":"Permite gestionar clientes, proveedores, bancos, facturas, asientos y registros en la contabilidad."},{"name":"title","value":"API Suasor Contable "}],"appearance":{"default":"light","themes":[{"name":"dark","logo":"https://content.pstmn.io/e4239bb3-31de-45a2-9ea6-44413af78908/aW1hZ2VuICgyKS5wbmc=","colors":{"top-bar":"212121","right-sidebar":"303030","highlight":"FF6C37"}},{"name":"light","logo":"https://content.pstmn.io/e4239bb3-31de-45a2-9ea6-44413af78908/aW1hZ2VuICgyKS5wbmc=","colors":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"}}]}},"version":"8.12.12","publishDate":"2026-11-11T15:12:34.000Z","activeVersionTag":"latest","documentationTheme":"light","metaTags":{"title":"API Suasor Contable ","description":"Permite gestionar clientes, proveedores, bancos, facturas, asientos y registros en la contabilidad."},"logos":{"logoLight":"https://content.pstmn.io/e4239bb3-31de-45a2-9ea6-44413af78908/aW1hZ2VuICgyKS5wbmc=","logoDark":"https://content.pstmn.io/e4239bb3-31de-45a2-9ea6-44413af78908/aW1hZ2VuICgyKS5wbmc="}},"statusCode":200},"environments":[],"user":{"authenticated":false,"permissions":{"publish":false}},"run":{"button":{"js":"https://run.pstmn.io/button.js","css":"https://run.pstmn.io/button.css"}},"web":"https://www.getpostman.com/","team":{"logo":"https://postman-image-service.postman.com/api/cloudinary-proxy/postman/image/upload/t_team_logo_pubdoc/v1/team/46251b563559223bb14ea8ba2d4940f349c3a323140b1264fe798f893d58ebf0","favicon":"https://summarbysilae.es/favicon.ico"},"isEnvFetchError":false,"languages":"[{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"HttpClient\"},{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"RestSharp\"},{\"key\":\"curl\",\"label\":\"cURL\",\"variant\":\"cURL\"},{\"key\":\"dart\",\"label\":\"Dart\",\"variant\":\"http\"},{\"key\":\"go\",\"label\":\"Go\",\"variant\":\"Native\"},{\"key\":\"http\",\"label\":\"HTTP\",\"variant\":\"HTTP\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"OkHttp\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"Unirest\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"Fetch\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"jQuery\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"XHR\"},{\"key\":\"c\",\"label\":\"C\",\"variant\":\"libcurl\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Axios\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Native\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Request\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Unirest\"},{\"key\":\"objective-c\",\"label\":\"Objective-C\",\"variant\":\"NSURLSession\"},{\"key\":\"ocaml\",\"label\":\"OCaml\",\"variant\":\"Cohttp\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"cURL\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"Guzzle\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"HTTP_Request2\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"pecl_http\"},{\"key\":\"powershell\",\"label\":\"PowerShell\",\"variant\":\"RestMethod\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"http.client\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"Requests\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"httr\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"RCurl\"},{\"key\":\"ruby\",\"label\":\"Ruby\",\"variant\":\"Net::HTTP\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"Httpie\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"wget\"},{\"key\":\"swift\",\"label\":\"Swift\",\"variant\":\"URLSession\"}]","languageSettings":[{"key":"csharp","label":"C#","variant":"HttpClient"},{"key":"csharp","label":"C#","variant":"RestSharp"},{"key":"curl","label":"cURL","variant":"cURL"},{"key":"dart","label":"Dart","variant":"http"},{"key":"go","label":"Go","variant":"Native"},{"key":"http","label":"HTTP","variant":"HTTP"},{"key":"java","label":"Java","variant":"OkHttp"},{"key":"java","label":"Java","variant":"Unirest"},{"key":"javascript","label":"JavaScript","variant":"Fetch"},{"key":"javascript","label":"JavaScript","variant":"jQuery"},{"key":"javascript","label":"JavaScript","variant":"XHR"},{"key":"c","label":"C","variant":"libcurl"},{"key":"nodejs","label":"NodeJs","variant":"Axios"},{"key":"nodejs","label":"NodeJs","variant":"Native"},{"key":"nodejs","label":"NodeJs","variant":"Request"},{"key":"nodejs","label":"NodeJs","variant":"Unirest"},{"key":"objective-c","label":"Objective-C","variant":"NSURLSession"},{"key":"ocaml","label":"OCaml","variant":"Cohttp"},{"key":"php","label":"PHP","variant":"cURL"},{"key":"php","label":"PHP","variant":"Guzzle"},{"key":"php","label":"PHP","variant":"HTTP_Request2"},{"key":"php","label":"PHP","variant":"pecl_http"},{"key":"powershell","label":"PowerShell","variant":"RestMethod"},{"key":"python","label":"Python","variant":"http.client"},{"key":"python","label":"Python","variant":"Requests"},{"key":"r","label":"R","variant":"httr"},{"key":"r","label":"R","variant":"RCurl"},{"key":"ruby","label":"Ruby","variant":"Net::HTTP"},{"key":"shell","label":"Shell","variant":"Httpie"},{"key":"shell","label":"Shell","variant":"wget"},{"key":"swift","label":"Swift","variant":"URLSession"}],"languageOptions":[{"label":"C# - HttpClient","value":"csharp - HttpClient - C#"},{"label":"C# - RestSharp","value":"csharp - RestSharp - C#"},{"label":"cURL - cURL","value":"curl - cURL - cURL"},{"label":"Dart - http","value":"dart - http - Dart"},{"label":"Go - Native","value":"go - Native - Go"},{"label":"HTTP - HTTP","value":"http - HTTP - HTTP"},{"label":"Java - OkHttp","value":"java - OkHttp - Java"},{"label":"Java - Unirest","value":"java - Unirest - Java"},{"label":"JavaScript - Fetch","value":"javascript - Fetch - JavaScript"},{"label":"JavaScript - jQuery","value":"javascript - jQuery - JavaScript"},{"label":"JavaScript - XHR","value":"javascript - XHR - JavaScript"},{"label":"C - libcurl","value":"c - libcurl - C"},{"label":"NodeJs - Axios","value":"nodejs - Axios - NodeJs"},{"label":"NodeJs - Native","value":"nodejs - Native - NodeJs"},{"label":"NodeJs - Request","value":"nodejs - Request - NodeJs"},{"label":"NodeJs - Unirest","value":"nodejs - Unirest - NodeJs"},{"label":"Objective-C - NSURLSession","value":"objective-c - NSURLSession - Objective-C"},{"label":"OCaml - Cohttp","value":"ocaml - Cohttp - OCaml"},{"label":"PHP - cURL","value":"php - cURL - PHP"},{"label":"PHP - Guzzle","value":"php - Guzzle - PHP"},{"label":"PHP - HTTP_Request2","value":"php - HTTP_Request2 - PHP"},{"label":"PHP - pecl_http","value":"php - pecl_http - PHP"},{"label":"PowerShell - RestMethod","value":"powershell - RestMethod - PowerShell"},{"label":"Python - http.client","value":"python - http.client - Python"},{"label":"Python - Requests","value":"python - Requests - Python"},{"label":"R - httr","value":"r - httr - R"},{"label":"R - RCurl","value":"r - RCurl - R"},{"label":"Ruby - Net::HTTP","value":"ruby - Net::HTTP - Ruby"},{"label":"Shell - Httpie","value":"shell - Httpie - Shell"},{"label":"Shell - wget","value":"shell - wget - Shell"},{"label":"Swift - URLSession","value":"swift - URLSession - Swift"}],"layoutOptions":[{"value":"classic-single-column","label":"Single Column"},{"value":"classic-double-column","label":"Double Column"}],"versionOptions":[],"environmentOptions":[{"value":"0","label":"No Environment"}],"canonicalUrl":"https://apisuasor-contable.summarbysilae.es/view/metadata/2sBYHaMwMg"}