Overview técnico
:::info Contexto técnico Esta sección documenta endpoint, estructura de payload, ejemplo de DTE/GUF y respuesta esperada para la integración con Oracle NetSuite. :::
1. Endpoint de API
Ambiente QA
https://developers-sbx.gosocket.net/api/v1/Document/SendDocumentToAuthority
Ambiente PRD
https://developers.gosocket.net/api/v1/Document/SendDocumentToAuthority
:::tip Recomendación de uso Validar primero en QA y pasar a PRD únicamente cuando la estructura del request y las respuestas estén verificadas. :::
2. Payload Esperado
Request generado por Oracle NetSuite:
{
"headers": {
"Content-Type": "application/json",
"Authorization": "Basic {custsecret_test_gosocket_cred}"
},
"body": "{\"mapping\":\"11111111-1111-1111-1111-111111111111\",\"sign\":\"true\",\"defaultCertificate\":true,\"async\":\"false\",\"fileContent\":\"<?xml version=\\\"1.0\\\" encoding=\\\"utf-8\\\"?>..."
}
DTE/GUF Generado por Oracle NetSuite para ser embebido en el request:
Ver XML DTE/GUF
<DTE version="1.0">
<Documento ID="">
<Encabezado>
<IdDoc>
<Ambiente>2</Ambiente>
<TipoServicio>10</TipoServicio>
<Tipo>01</Tipo>
<Serie>SETT</Serie>
<Numero>2000774</Numero>
<NumeroInterno>SETT2000774</NumeroInterno>
<FechaEmis>2026-02-10T00:00:00Z</FechaEmis>
<MedioPago>1</MedioPago>
<FechaVenc>2026-02-25</FechaVenc>
<TipoNegociacion>2</TipoNegociacion>
</IdDoc>
<Emisor>
<TipoContribuyente>1</TipoContribuyente>
<IDEmisor>901070618</IDEmisor>
<NmbEmisor>NETSOFT COLOMBIA</NmbEmisor>
<NombreEmisor>
<PrimerNombre>NETSOFT COLOMBIA</PrimerNombre>
</NombreEmisor>
<CodigoEmisor>
<TpoCdgIntEmisor>TpoObl</TpoCdgIntEmisor>
<CdgIntEmisor>O-13;O-15</CdgIntEmisor>
</CodigoEmisor>
<DomFiscal>
<Calle>CR 7 127 08</Calle>
<Departamento>11</Departamento>
<Ciudad>11001</Ciudad>
<Pais>CO</Pais>
<CodigoPostal>BOGOTÁ, D.C. 110111</CodigoPostal>
</DomFiscal>
<LugarExped>
<Calle>CR 7 127 08</Calle>
<Departamento>11</Departamento>
<Ciudad>11001</Ciudad>
<Pais>CO</Pais>
<CodigoPostal>BOGOTÁ, D.C. 110111</CodigoPostal>
</LugarExped>
<ContactoEmisor>
<eMail>localizacion.netsoft@gmail.com</eMail>
</ContactoEmisor>
</Emisor>
<Receptor>
<TipoContribuyenteR>1</TipoContribuyenteR>
<DocRecep>
<TipoDocRecep>31</TipoDocRecep>
<NroDocRecep>9010416563</NroDocRecep>
</DocRecep>
<NmbRecep>ALIMENTOS CÁRNICOS & LA SEVILLANA SAS</NmbRecep>
<NombreRecep>
<PrimerNombre>ALIMENTOS CÁRNICOS & LA SEVILLANA SAS</PrimerNombre>
</NombreRecep>
<CodigoReceptor>
<TpoCdgIntRecep>TpoObl</TpoCdgIntRecep>
<CdgIntRecep>O-13;O-15</CdgIntRecep>
</CodigoReceptor>
<DomFiscalRcp>
<Calle>CR 7 127 08</Calle>
<Departamento>11</Departamento>
<Ciudad>11001</Ciudad>
<Pais>CO</Pais>
<CodigoPostal>760001</CodigoPostal>
</DomFiscalRcp>
<LugarRecep>
<Calle>CR 7 127 08</Calle>
<Departamento>11</Departamento>
<Ciudad>11001</Ciudad>
<Pais>CO</Pais>
<CodigoPostal>760001</CodigoPostal>
</LugarRecep>
<ContactoReceptor>
<Nombre>ALIMENTOS CÁRNICOS & LA SEVILLANA SAS</Nombre>
<Descripcion>ALIMENTOS CÁRNICOS & LA SEVILLANA SAS</Descripcion>
<eMail>localiza.netsoft@gmail.co</eMail>
<Telefono>345-0132</Telefono>
<Fax>345-0132</Fax>
</ContactoReceptor>
</Receptor>
<Totales>
<Moneda>COP</Moneda>
<FctConv>1</FctConv>
<SubTotal>1200.000</SubTotal>
<MntDcto>0.00</MntDcto>
<MntRcgo>0.00</MntRcgo>
<MntBase>1200.000</MntBase>
<MntImp>228.000</MntImp>
<MntRet>0.000</MntRet>
<VlrPagar>1428.00000</VlrPagar>
</Totales>
<Impuestos>
<TipoImp>01</TipoImp>
<TasaImp>19.00</TasaImp>
<MontoBAseImp>1200.00</MontoBAseImp>
<MontoImp>228.00</MontoImp>
</Impuestos>
</Encabezado>
<Detalle>
<NroLinDet>1</NroLinDet>
<CdgItem>
<TpoCodigo>999</TpoCodigo>
<VlrCodigo>400 Watt Power Supply</VlrCodigo>
</CdgItem>
<DscItem>400 Watt Power Supply</DscItem>
<QtyItem>1</QtyItem>
<SubQtyItem>
<SubCod>ACC00001</SubCod>
<SubQty>1</SubQty>
</SubQtyItem>
<UnmdItem>94</UnmdItem>
<ImpuestosDet>
<TipoImp>01</TipoImp>
<TasaImp>19.00</TasaImp>
<MontoBaseImp>1200.00</MontoBaseImp>
<MontoImp>228.00</MontoImp>
</ImpuestosDet>
<PrcBrutoItem>1200.000</PrcBrutoItem>
<MontoTotalItem>1200.00</MontoTotalItem>
</Detalle>
<CAE>
<Tipo>01</Tipo>
<Serie>SETT</Serie>
<NumeroInicial>1</NumeroInicial>
<NumeroFinal>5000000</NumeroFinal>
<NroResolucion>18760000001</NroResolucion>
<FechaResolucion>2019-01-19</FechaResolucion>
<ClaveTC>fc8eac422eba16e22ffd8c6f94b3f40a6e38162c</ClaveTC>
<Plazo>2030-01-19</Plazo>
</CAE>
<Personalizados>
<DocPersonalizado></DocPersonalizado>
</Personalizados>
</Documento>
</DTE>
:::note Referencia
El XML mostrado corresponde al contenido que se embebe en el campo fileContent del request.
:::
3. Respuesta del API
Response recibido por Oracle NetSuite:
{
"Success": true,
"GlobalDocumentId": "0908f23d-4fc9-45bf-4cbd-52f9269f0d20",
"CountryDocumentId": "41a64fc7f4d8d4e3408abccbc966c22af92b814fb0e46f78a9d4cb2409350d2357e3c03e066fa158c8d1d75eb6ac2621",
"OtherData": {
"Country": "co",
"Certifier": "DIAN",
"AuthorityTimeStamp": "10/02/2026 17:52:33",
"BarCodeText": "https://catalogo-vpfe-hab.dian.gov.co/document/searchqr?documentkey=41a64fc7f4d8d4e3408abccbc966c22af92b814fb0e46f78a9d4cb2409350d2357e3c03e066fa158c8d1d75eb6ac2621"
},
"Messages": [
"Regla: FAJ74, Notificación: Estructura código no valida",
"Regla: FAJ73, Notificación: Estructura código no valida",
"Regla: FAJ43b, Notificación: Nombre informado No corresponde al registrado en el RUT con respecto al Nit suminstrado."
],
"ResponseValue": "PD94bWwgdm...RESTO DEL CONTENIDO"
}
4. Tipos de Documentos por País Certificado
Colombia - Tipos de Documentos Alcanzados
- 01 - Factura de venta nacional
- 02 - Factura de exportación
- 03 - Factura por contingencia facturador
- 03 - Factura por contingencia facturador - Exportación
- 04 - Factura de contingencia DIAN
- 04 - Factura de contingencia DIAN - Exportación
- 05 - Documento soporte
- 91 - Nota de crédito
- 92 - Nota de débito
- 95 - Nota de ajuste
Chile - Tipos de Documentos Alcanzados
(Por definir)