Json Factura de Exportación

Json Factura de Exportación

Método de envío.

Para el proceso de pruebas de la factura de exportación recuerde

  1. Solicitar el TOKEN
  2. Valide el parámetro de envió para pruebas

        «sMethod»: «classTaxxa.fjDocumentAdd»,

        «jParams»: {

            «wVersionUBL»: 2.1,

            «wEnvironment»: «test»,

El ambiente de producción debe ajustar el parámetro de la siguiente forma:

        «sMethod»: «classTaxxa.fjDocumentAdd»,

        «jParams»: {

            «wVersionUBL»: 2.1,

            «wEnvironment»: «prod»,

Es importante tener en cuenta el prefijo sino la factura será rechazada, a continuación, se especifican los campos adicionales que se deben adicionar en el JSON para la factura de exportación, a continuación encontrará  un json de ejemplo. Finalmente   al final del documento encontrará  los  campos aplicables a este tipo de factura con la explicación y catalogo que corresponda.

				
					{
    "sToken": "000000000",
    "jApi": {
        "sMethod": "classTaxxa.fjDocumentAdd",
        "jParams": {
            "wVersionUBL": 2.1,
            "wEnvironment": "test",
            "jDocument": {
                "sdocumentprefix": "SETP",
                "sdocumentsuffix": 990000000,
                "wdocumenttype": "Invoice",
                "wdocumenttypecode": "02",
                "scustomizationid": "10",
                "wcurrency": "COP",
                "wpaymentmeans": "1",
                "spaymentmethod": "10",
                "tissuedate": null,
                "tduedate": "2024-02-29",
                "sLossRiskResponsibilityCode": "CFR",
                "sLossRisk": "Costo y Flete",
                "nlineextensionamount": 3418.81,
                "ntaxinclusiveamount": 3978.17,
                "npayableamount": 3978.17,
                "rdocumenttemplate": 76497579,
                "snotes": "TERMINOS DE NEGOCIACION EXW FACTURA DE EXPORTACION TCR 3925 PESOS CON 50 CENTAVOS VALOR EN DOLARES 7115 DOLARES CON 40 CENTAVOS",
                "snotetop": "IVA R?gimen Com?n No somos Agentes de Retenci?n de IVA No somos Grandes Contribuyentes Actividad Econ?mica ICA 4520 9.66 X 1000",
                "ntrm": 3957,
                "nSourceCurrencyBaseRate": 2944,
                "tdatetrm": "2024-05-01",
                "sTargetCurrencyCode": "USD",
                "nTargetCurrencyBaseRate": 1,
                "jtotalescop": {
                    "nFctConvCop": 5000,
                    "sMonedaCop": "USD",
                    "nSubTotalCop": 200,
                    "nDescuentoDetalleCop": 0.00,
                    "nRecargoDetalleCop": 0.00,
                    "nTotalBrutoFacturaCop": 200,
                    "nTotIvaCop": 38.00,
                    "nTotIncCop": 0.00,
                    "nTotBolCop": 0.00,
                    "nImpOtroCop": 0.00,
                    "nMntImpCop": 0.00,
                    "nTotalNetoFacturaCop": 238.00,
                    "nMntDctoCop": 0.00,
                    "nMntRcgoCop": 0.00,
                    "nVlrPagarCop": 238.00,
                    "nReteFueCop": 3.00,
                    "nReteIvaCop": 0.00,
                    "nReteIcaCop": 0.00,
                    "nTotAnticiposCop": 0.00
                },
                "jadditionalexport": {
                    "0": {
                        "sname": "Responsable/Encargado",
                        "sValue": "sebastian"
                    },
                    "1": {
                        "sname": "Lugar de Salida",
                        "sValue": "Bogota"
                    },
                    "2": {
                        "sname": "Medio de transporte",
                        "sValue": "Avion"
                    },
                    "3": {
                        "sname": "Tipo de Doc.de transporte",
                        "sValue": "Remisión"
                    },
                    "4": {
                        "sname": "N° de Doc. de transporte",
                        "sValue": "098526"
                    },
                    "5": {
                        "sname": "Transportadora o Tramitadora",
                        "sValue": "Avianca"
                    },
                    "6": {
                        "sname": "País de Origen de la M/cia",
                        "sValue": "Colombia"
                    },
                    "7": {
                        "sname": "Destino",
                        "sValue": "Miami"
                    },
                    "8": {
                        "sname": "Términos de pago",
                        "sValue": "contraentrega"
                    },
                    "9": {
                        "sname": "Seguro",
                        "sValue": "Alianzas Internacionales"
                    },
                    "10": {
                        "sname": "Observaciones",
                        "sValue": "Ninguna"
                    }
                },
                "jseller": {
                    "wlegalorganizationtype": "person",
                    "sfiscalresponsibilities": "R-99-PN",
                    "sdocid": "901402281",
                    "sdoctype": "NIT",
                    "ssellername": "RAZON SOCIAL DEL VENDEDOR COMO SE  ENCUENTRA EN EL RUT",
                    "ssellerbrand": "NOMBRE COMERCIAL DEL ESTABLECIMIENTO",
                    "scontactperson": "NOMBRE PERSONA DE CONTACTO",
                    "saddresszip": "110001",
                    "wdepartmentcode": "11",
                    "wtowncode ": "11001",
                    "scityname": "BOGOTA",
                    "jcontact": {
                        "selectronicmail": "correo@correo.com",
                        "jregistrationaddress": {
                            "wdepartmentcode": "85",
                            "scityname": "RIOHACHA - LA GUAJIRA",
                            "saddressline1": "CL 13 11 75",
                            "scountrycode": "CO",
                            "wprovincecode": "44001",
                            "szip": "440001",
                            "sdepartmentname": "GUAJIRA"
                        }
                    }
                },
                "jbuyer": {
                    "wlegalorganizationtype": "company",
                    "sbuyername": "NOMBRE O RAZÓN SOCIAL DEL COMPRADOR",
                    "sfiscalresponsibilities": "R-99-PN",
                    "jpartylegalentity": {
                        "wdoctype": "FI",
                        "sdocno": "0000000000"
                    },
                    "jcontact": {
                        "selectronicmail": "",
                        "stelephone": "00000",
                        "scontactperson": "XXXXXXXXXX",
                        "jdelvieryaddress": {
                            "wcountrycode": "us",
                            "scityname": "MIAMI",
                            "szip": "11001",
                            "saddressline1": "Dirección de ejemplo para entrega de item",
                            "tdatedelivery": "2024-01-02",
                            "ttimedelivery": "02:02:02"
                        },
                        "jregistrationaddress": {
                            "saddressline1": "XXXXXXXXXXXXXXXX",
                            "scountrycode": "US",
                            "wdepartmentcode": "33",
                            "sdepartmentname": "MIAMI",
                            "wprovincecode": "33027",
                            "scityname": "PEMBROKE PINES",
                            "szip": "000000"
                        },
                        "jphysicallocationaddress": {
                            "saddressline1": "XXXXXXXXXXXXXXX",
                            "scountrycode": "US",
                            "wdepartmentcode": "33",
                            "sdepartmentname": "MIAMI",
                            "wprovincecode": "33027",
                            "scityname": "PEMBROKE PINES",
                            "szip": "000000",
                            "wlanguage": "es"
                        }
                    }
                },
                "jextrainfo": {
                    "ssalespersonname": "GERENCIA",
                    "iitemscount": 10,
                    "spesobruto": "9106.29",
                    "spesoneto": "8465.09",
                    "sremision": "REM-223872",
                    "spedido": "Pve-138841",
                    "spallets": "18",
                    "stransport": "TRANSINVER CTC SA",
                    "tdateremision": "2024-04-30",
                    "sguia": "",
                    "splaca": "TFQ-145",
                    "spaymentcondition": "100% ANTICIPADO"
                },
                "jdocumentitems": {
                    "1": {
                        "jextrainfo": {
                            "sbarcode": "00012",
                            "sBrandName": "lenovo",
                            "sModelName": "2024"
                        },
                        "sdescription": "ITEM DESCRIPCIÓN",
                        "sstandarditemidentification": "7707223335010",
                        "nunitprice": 2944,
                        "nusertotal": 3418.81,
                        "notherunitprice": 3500,
                        "nothertotal": 3500,
                        "nquantity": 1,
                        "wunitcode": "94",
                        "wproductcodetype": "999",
                        "adescription": {
                            "0": "TERMINOS DE NEGOCIACiÓN"
                        },
                        "jtax": {
                            "jiva": {
                                "nrate": 19,
                                "sname": "IVA",
                                "namount": 559.36,
                                "nbaseamount": 2944
                            }
                        }
                    }
                },
                "idocprecision": 2
            }
        }
    }
}
				
			

Campo

Descripción/Catalogo

«wdocumenttypecode»:

02 = Código de factura de exportación

«wcurrency«:

Debe ir por defecto COP

«ntrm»:

Valor de la tasa de cambio entre las divisas

«nSourceCurrencyBaseRate»

Base monetaria de la divisa COP que se deberá convertir a moneda extranjera, ejemplo: si es USD el valor a informar es el valor equivalente de un dólar en pesos.

«tdatetrm»

Fecha en la que se fijó la tasa de cambio (CalculationRate)

«rdocumenttemplate»:
Para la factura de exportación si no cuenta con un formato personalizado puede enviar por defecto el código 76497579 sin comillas

«sTargetCurrencyCode»

Divisa a la cual se hace la conversión ejemplo USD

«nTargetCurrencyBaseRate»: 1,

Enviar valor por defecto 1 sin decimales

«sLossRiskResponsibilityCode»: «CFR«,

Condiciones de Entrega: Campo para que emisor pueda informar condiciones de entrega Código

«sLossRisk»: «Costo y Flete«

Condiciones de Entrega: Campo para que emisor pueda informar condiciones de entrega, Descripción

Código

Significado

CFR

Costo y flete

CIF

Costo, flete y seguro

CIP

Transporte y Seguro Pagados hasta

CPT

Transporte Pagado Hasta

DAP

Entregado en un Lugar

DDP

Entregado con Pago de Derechos

DPU

Entregada en Lugar Descargada

EXW

En Fábrica

FAS

Franco al costado del buque

FCA

Franco transportista

FOB

Franco a bordo

Codigo

Descripción/Catalogo

«nMntDctoCop»: 0.00,

Descuento en otra moneada

«nMntRcgoCop»: 0.00,

Recargo en otra moneada

«nVlrPagarCop»: 238.00,

Valor a pagar en otra moneada

«nReteFueCop»: 3.00,

ReteFuente en otra moneada

«nReteIvaCop»: 0.00,

ReteIva en otra moneada

«nReteIcaCop»: 0.00,

ReteIca en otra moneada

«nTotAnticiposCop»: 0.00

Total, anticipos otra moneada

«nFctConvCop»: 5000,

Valor bruto antes de tributos otra moneada

«sMonedaCop»: «USD»,

Nombre de moneda otra moneada

«nSubTotalCop»: 200,

Sub Total otra moneada

«nDescuentoDetalleCop»: 0.00,

Campo para informar el total de los descuentos otra moneada

«nRecargoDetalleCop»: 0.00,

Campo para informar el total de los recargos otra moneada

«nTotalBrutoFacturaCop»: 200,

Campo para informar el total bruto otra moneada

«nTotIvaCop»: 38.00,

Campo para informar el total IVA otra moneada

«nTotIncCop»: 0.00,

Campo para informar el total INC otra moneada

«nTotBolCop»: 0.00,

Campo para informar el total de la bolsa otra moneada

«nImpOtroCop»: 0.00,

Campo para total de otros cobros otra moneada

«nMntImpCop»: 0.00,

 

«nTotalNetoFacturaCop»: 238.00,

Valor total a pagar otra moneada

«nMntDctoCop»: 0.00,

Descuento en otra moneada

«nMntRcgoCop»: 0.00,

Recargo en otra moneada

«nVlrPagarCop»: 238.00,

Valor a pagar en otra moneada

«nReteFueCop»: 3.00,

ReteFuente en otra moneada

«nReteIvaCop»: 0.00,

ReteIva en otra moneada

«nReteIcaCop»: 0.00,

ReteIca en otra moneada

«nTotAnticiposCop»: 0.00

Total, anticipos en otra moneada

Campo

Descripción / Catalogo

«0»: {

«sname»: «Responsable/Encargado»,

«sValue»: «sebastian»

     }

Enumere cada sección adicional que desea enviar no repita la numeración

Envié el campo sname con la etiqueta de la información adicional

Envié el campo sValue con la información que deseé.

«1»: {

  «sname»: «Lugar de Salida»,

  «sValue»: «Bogota»

    }

Enumere cada sección adicional que desea enviar no repita la numeración

Envié el campo sname con la etiqueta de la información adicional.

Envié el campo sValue con la información que deseé.

Campo

Descripción / Catalogo

«spesobruto»:»9106.29″,Peso Bruto del envio
«spesoneto»:»8465.09″,Peso Neto del envio
«sremision»:»REM-223872″,Numero de Remisión
«spedido»:»Pve-138841″,Numero de Pedido
«spallets»:»18″,Numero de empaques
«stransport»:»TRANSINVER CTC SA»,Empresa transportadora
«tdateremision»:»2024-04-30″,Fecha de remisión  de la orden
«sguia»:»»,Numero de Guia
«splaca»:»TFQ-145″,Numero de Placa carro transportador 
«spaymentcondition»:»100% ANTICIPADO»Condiciones de Pago